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0, Rotation Used U tills Manual 

0.1 Umber 1 

All numbsrs written la. arable: numerals are octal except as follows: (1) 
those part of a nams, such as a type ' , 35'‘ tala type, (t) those part of the 
me ta-fl true tape of this- sanuai (a pa ge or section number for example), (31 or 
those that are floating paint, which will always have more than one digit to 
the right of the decimal point. Humbera that are Written alphabetically are 
decimal, 

0.2 Character Objects and Strings 

Character objects and strings are usually surrounded hy quotation maria 
(*"") and are relatively clear from context, Hem-graphic characters created by 
holding dean the control shift of a teletype and striking a graphic are 
represented by the graphic proceeded by a as In "a for ^control-A". 

0,3 Bit Positions and Intervals 

Bit positions la thirty-six bit words are represented by the concatenation 
of a digit from 1'through 4„ a and a digit froa 1 through 3. The first 
digit is a quadrant number starting from the right or least arithmetically 
significant part of the word, The second digit la a bit number in the 
guairant, also starting from the right or least significant bit. Thus 1,1 is 
the lowest bit and 4,9 the sign bit. 
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Bit lnter?als are represented toy the concatenation of an included startlet 
bit position, a and an Included terminating position* Thus 3.3-3* 1 la the 
lowest octal digit In the left half of a word, 

£L4 Internal References 

Most Internal references In the text of this manual are of the following 
fortni [App i] , [Ref i ] , an! [Sec x] * These refer, raspec tirely, to the x th 
appendix, the r th Item In the section of this sanaal entitled "Reference!% 
and the x' th nuaharad section o-f this manual* Other lot area], references are 
written out in lees foreality and forms whose meaning should he evident* such 
is the following, are allowed! [Sec x, 7 ], [App it Ref x P y] , ate* 
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1* Introduction to and Goals of ITS 

The Incompatible Tins Sharing system fITS) Is a control program tailored 
to the Project MAC Artificial Intelligence UI) Croup PDF-5 installation* It 
was do signed in an attempt to pro?Ida the following potential advantages of a 
time sharing system: 

(1) More than one pereon can perform tasks not redairing all available coaputer 
resources with soasiis simultaneity;. one person can similarly perform seT&ral 
tasks, 

(3.) Each user lias batter control oyer hardware and greater ease in debugging 
software due to appropriate designed-in features, 

(3) Jots which would otberwlss require excessive blocks of time can he 
performed automatically tn email parts over long periods of time when the 
computer would otherwise he Idle. 

(4) Programs can more easily he made independent of specific input and output 
devices. 

It was desired to achieve these goals without the usual pensItLae of time 
sharing systems such as rancid response and passive inefficiency and. their 
attendant evils such as required break characters, arbitrary built in command, 
levels of dubious virtue, and severe core restrictions due to a bloated 
monitor. 

lor thess and other reasons ITS was designed with the following 
propertiesj 
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(l) ITS sits la control of the PDP-6 perfuming neat input-output for and 
allocating machine resources among various user pro grain * 

(£) All user programs resIds in core storage so It Is possible to switch 
between programs with great rapidity and have sufficiently short quanta to 
allow character response without undue inefficiency. (The coating installation 
of additional dish storage will enable the swapping of programs but it Is 
etpec ted that oily doriant programs will he swapped out,) 

(3) ITS has only a minimaL direct user command facility to assure users that 
they can maintain control over their programs. Almost all system actions are 
the result of systems calls executed by the user's programs. 

(4) ITS attempts to provide staple standardised iaiput-outpui and other system 
calls as well as more complex and specialised calls which reduce overhead or 
enable the use of Special devices and features. 


MIDAS, a machine language assembler with macro facilities (Sef 3, 10], wae 
chosen for writing ITS because of the resultant efficiency, flexibility, ease 
in writing, and ease In debugging. Tor information beyond or more recent than 
this manual consult the sources listed in Appendix D. 


1.1 Preview of Section £ 

The user of ITS- noraally commands a hierarchy of programs in machine 
storage organ Lied In an Inverted tree. The top procedure Is Initially loaded 
for hi* by the system when he types a on an idle console. All programs may 
have inferior procedures which they control. Almost all commands to the system 
are machine Instructions [App A; Ref l], which trap to the monitor, executed 
for the user by his programs* The only exception is that he nay Interrupt the 
superior procedure of the program with which he is conversing by typing "'z, fly 
this method the user can return to his top procedure at which point "Vs typed 
on hie console are ignored by the aystea. 
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1*2 is* Of Sections 3 and 4 

The maj OTity of the Code far the ITS muni Ear is devoted to input-output* 

It Ha* been organized with such goals lh mind as fieritillty, speed, and 
generality. Staple device Ialependent aystea calls are available whore 
meaningful, and a coo tin mid, to the specialized system calls necessary to make 
nearly full use of some specialized devices exists. Most devices are 
referenced symbolically [App bJ and procedures may cause syibolic trapalatiout 
such that an Inferior procedure referencing a particular 4s vies will in fact 
get a different device. Input-output may be done a character or word per 
system call or, for le3s overhead per character or word, an arbitrary site 
block of words may be transfered into* or out of the user program's care with 
one system call. The user program is not required to hava any buffers Id its 
core image* Many special features relate to consoles or special devices an the 
PDP-6 such as ayes, arms or the DEC 340 display, 

1,3 Preview of Section 5 

A feature of tha ITS monitor not frequently found In time sharing systems 
and contributing greatly to its flexibility and generality Is that user 
programs may receive software implemented, interrupts in much the same way that 
ITS receives hardware interrupts* The system Is so designed that the user Is 
rarely Involuntarily uninterruptable for more thao a few hundred adornsecoada. 
If the interrupt is dismissed la a normal manner the non-iaterrupt portion of 
the prograa can proceed even from the '’middle" of a system call taking an 
arbitrary amount of time* 
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k scheduling al^orlthffl is used which tries primarily to e^ualiae machine 
tins used by each active procedure tree (console) ani secondarily to equalise 
machine time muons those procedures in each tree. The system variables relate! 
to a particular procedure [App C] used hy the scheduler and other parts of ITS 
are Kept In system memory and do not lmpiose on the usar J s core imase, 

1.4 Preview of Section 5 

User programs operatin? within the environment provided by ITS are 
Omani tad (as man tinned in 1*£) *3 I ore r ted tree hierarchies* Superior 
procedures can retriers and atore yards in their Inferior procedures an If they 
yere input-output derices * There also exists a larse get of special system 
calls for controllins procedures immediately beneath them and several special 
rays that procedures may communicate with thsir superior procedure. Buffered 
communication between arbitrary pair a of procedures treatin'? each Other as 
Input-output devices Is also provided* 

1.5 Preview of Section 7 

k Lar«e number of miscellaneous system calls and features exist for a 
variety of purposes* Many provide easy input-output to devices which do act 
fit the forma of'standard TTS devices. Others provide the usO of certain 
hardware modification* to tbs PEP-5 which enable the simulation of certain 
features of manual control of the PDP-5 such as address stop* The remainder 
are such minor but necessary functions as la?in and logout* 

A special procedure, known as the system job, elite under ITS* It 
performs various low priority functions for the system and checks constant 
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portions of ITS asalnst a co$y in an atteipt to detect some forms of system or 


hardware failure. 
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2 V Getting the Attention of and Transmitting Commands to ITS 

2*1 Control 1 

The only item of input-output data recogntied by ITS directly as a command 
is the character (rhea received from an idle teletype {a member of the cl&ss 
of devices that may be consoles* currently either a &E terminal or a E5R 35/37) 
or from an active console, that is a teletype in control of a procedure tree* 
Teletypes may also be in use as ordinary devices {as Tun instead of TTY [Sac 
4*5]) in which case ITS ignores ^Z'a typed oa thorn* 

If the teletype was Idle* *2 norsally causes the teletype to become a 
console and loads and starts as its top level procedure [Sec 6*1] the dump file 
named "£ HiCTM* 1, on device SYS, or if not found there from device UT2 {see 
section 3*1 for a discussion of file and device names). The JKAMB of a thus 
initiated procedure is HTK and its ITOAHE and STjUS are set to the value minus 
□oe [See 3.3*4, S.L]* This will not happen if there is insufficient memory 
available, if the syataa is ituown to be going down soon [Sec 7.5.2], or if too 
saay people type ~Z simultaneously, ITS- will echo a tyoad on an idle 
teletype if and only if it succeeded in starting a top procedure* 

The effect of ~Z in the second case* that of an active console, Is 
Intended to be each that the user at the console nay cause control of his 
console to revert"'to higher level procedures and uitisatly to his tap level 
procedure even in tha face of hostile inferiors, 

A ~Z typed on an active console is ignored by ITS if the cohsola is being 
controlled by its too level procedure. Otherwise it sats a flag associated 
with the console so that it may not be assigned downward in the procedure tree 
[Sec 1.0.1]. This flag is cleared only by typing any character other than t 
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on the console* ITS also sets the “l interrupt hit, a class one Interrupt [Sac 

5.2]* for the procedure controlling the console and possibly for an arbitrary 

(limber of procedures, each the immediate superior of the last, extending upward 

In the tree from the procedure controlling the Console* The condition for each 

a tap upward in the procedure tree Is that either the superior to the procedure 
( 

currently haying its Interrupt hit set is stopped or the current procedure 
waa found to already have its "z tit on* 

Action on * 2 Interrupt hits [Sec 5*2] set will he tales n In less than one 
quantum time when the scheduler [Sec 5.5j next runs* 

a 

2*2 Trapping Instructions 

rfith the exception of *2 ail c a sands to ITS are given by Instructions 
which trap to the monitor* All valii coaaan-is are from a class of instructions 
called UUO*S which are ChiracUrlied by an initial octal digit of 0* These are 
discussed In section 2*2-1 and listed Ip appendix A. Sadion 2.2.2 concerns all 
ether trapping' instructions* tt is a useful characteristic of the PT3P—6- that 
ao identical effecti?e address calculation U performed on all words fetched as 
instructions regardless of their operation cole or legality [Ref l] * Thus 
indexing and indirect addressing are avalTable op ill tripping instructions* 
Interrupts to the monitor as i resalt of conditions encountered in the 
execution of an Instruction {such as memory protection dotation, Alt overflow, 
PBE, overflow, etc) rather than the type of instruction are mentioned In section 
5 , 2 * 
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2*2*1 ULfO't 


Th« execution as Instructions of nordt rfltSi on operation cods [Raft] of 
ffODO 000 to 077 normally results in the ins traction word if a in? stored la 
absolute location 40 modified hy having had its effect Its address computed and 
stored in its address field and its indirect and. Index fields cleared. The 
instruction in absolute location 41 is then executed, Since all ITS- system 
calls Utilise only KGD's 040 thrown 04? She Project MAC 41 Group's P&P-S has 
beau modified so that UUD'e 0Q1 through 03? and &50 through D77 vlll trap* as 
described abare* directly to the user program's relocated tore image *ith no 
extra overheal. GUO 000 *111 also appear to trap to the user but this occurs 
via monitor simulation that checks to sea tr relocated location 41 directly 
addresses (indexing or indirect addressing ignored) a location between 2fl and 0 
lest than the top of the user's core image inclusive. If eo, a JSR to that 
location Is -slmulatad* If not, the user's illegal Instruction interrupt hit, a 
class t*o Interrupt [Sec 5*2], is turned on, 

A complete Hat of system calls ip numeric order appears in appendix A, 
However a list classified by operation code is includad here; 


UUq Symbol Description 

040 .IDT Executed for each Item or block of data transmitted 

between a user program and a symbolic Input-output derice [Sac 3,3], 

041 *DPEtf Used to initial tie Input-output between a device and a 
program [See 3,2]; 

042 ,0PE3 A class of system calls further decoded by the value of 

their effactlre address* 

043 .CALI A class of system calls further decoded by the value of 
their accumulator field, 

044 „U5£F Executed by procedures to examine and set some of the 

system variables associated ultii their inferior procedures {Sec 6,2,3]* 

043 *M3A I C Executed by a procedure to set the procedures * ARE AIT 
interrupt bit, a elate one interrupt [Sa -5 5.2] thug stopping It end 
interrupting its superior poreedore [Sec 5,3,2.], 
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MS *5T4T(J$ tfsed to ascertain the status of an input-output device, 
channel, or transfer [Sec 3*&]* 

04? Used la Input-output to randomly addressable device* [Sec 

5*3*5]* 

ITS system calls Wflr-9 desisnel to be numerically rather than symbolically 
decolad to decrease thsir bullcinasa and e umbei-sonneas and Increase monitor 
efficiency* 

2*2*3 flon—LTLTa Trapping Instructions 

the only other trapping Instructions are those whose first octal digit la 
T and the instruction JftSr with the 10 or 4 bit on in Ite accumulator field 
fftaf 13. The first of those two Includes all instructions which effect 
hardware Inpunsutimt and most of those affect ini the state of the PIlP^S 
Instruction processor (including aser/executlve mode)* lo the second the 10 
and 4 hits respectively iUaila? a hardware interrupt and stop the PDP-0. The 
execution of any of these trapping Instructions causes an illegal instruction 
Interrupt to the user (a class two interrupt, see section 5*2), The remaining 
way to affect the state of the processor Is a JRST Instruction with the 2 bit 
on in the a<5emulator field; however, in user moi* thle will not effect the 
state of the user, special or lot-user [Sec 7*3*5] modes except that it *ay 
turn off lot-user node* 
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3, Tie General Transaction of Input-Output 

3.1 Philosophy and Organisation 

Standard ITS Input-output has been organised with such goals as symbolic 
dettce lode pendent; a, no required buffering in the user J a core simple 

unit (character,, word, vlllsector point., stc-J sole transfers available along 
with bio zK at a time transfera which reduce overhand by reducing tie number of 
system calls, Bach procedure has associated with It 20 input-output channels 
(hut 3 $e sections 3*7, and 4.U). Each of those transfers in one direction and 
mode between the program and a file on a device with which the channel was 
associated by the execution of a ,0PES [Sec 3,3]* Items are then transit tel 
over the choanal by the execution of JOT'? [Sac 3.4]* This association may be 
teraln&ted by a .CLOSE {Sac 3,9,i] or another .OPIft on the same channel. 

A.11 lata transfers directly to or fro a symbolic ITS devices l^pp B] 

(except ¥ID, MTD, and some modes of I NIK] are effected to or from buffers in 
s/Stea memory. In the case of major file devices (HTn and DDn) thase buffers 
ara dynamically allocated from free nsaory by ITS [Sac 5.3]. The additional 
Overhead required to transmit data between a user's core Image ar.d the system's 
buffer as compared with a system having direct user core imago Input-output is 
negligible in comparison to any significant processing of the data. Using 
system buffers has the following adraotases; 
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(1) The user may he lo ter rutted, sapped out, moved in core, or otherwise 
molested during an *10T [Sec 3.4] as it is the software transfer of data 
between ay steal buffer a and hi a core. 

(2) Real input-output transfers say proceed without consIdarat ton of the state 
of the user program they are occuriug for as they are Into or out of emes 
controlled memory. 

(3) Higher core storage usage efficiency Is obtained due to the dynamic nature 
of major file device buffers. Even for devices with fixed buffers, such as the 
line printer, only one large buffer need exist regardless of how nany programs 
that could use the device are in the system. 

{4) User programs need not concern themselves with the size of physical blotto 
on devices. 


Some devices do not fit this framework very well and STS tea calls relating 
to them are Included In section 7, Miscellaneous calls related to particular 
symbolic devices are. however, Included under the device In section 4. 

3.2 The ,OFS* TO 


In put-nut put on a particular channel Is Initialized by eiaeutlng a ,OPE!I. 
The channel Is numerically specified by the accumulator field of the *OPCl and 
any previous transfer of that channel is terminated as if by a .CLOSE [Sac 
3.3,1]* Lf the user la interrupted [Sec 5.2] during a .Ota the channel muv 
have been closed, and not yet reopened. The effective address of the *QPEK 
should point to the first word of a blocfc of thres words in the user'a core 
image which specif/ a device, mode, and file* The second two words specify the 
two file names, As a convention, the file names are usually thought of as up 
to six, left justified, slxblt characters rather than thirty-six bit 
luantitles. taro file cases are act allowed on many devices and attempts to 
use them will cause the *Q?EJ to fall* The first word has the three character 
device name in its right half and the direction and mode in its left. 
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ImraedUtly beloJ are the standard node hits from this left half. 


Eitta} (Ceaniag 

4.9 l=>Delate or renane [Sec 3.53 rest of hits ignored* 

•;)»>Qpeu„ 

4.9^3* 4 Derlca dependent* 

3+3 i-*Image mode. 

Q=** ASCII moda. 

3.2 1—^-Block mode. 

0=*lfnlt mode. 

3,1 l-a-OutpUt. 

0"* 1 Input. 


The dorice aid file specified will ho altered by aft toils in the translation 
table [Sec 3.3] made hy either the procedure or any of Its superior procedures. 
Because of thle translation and the symbolic nature of *0PE$, it ta cue of the 
slower ITS system calls* 

If the .OPEd Is successful it will skip the Immediately following 
instruction. If not successful it will not skip and the reason for the failure 
may he ascertained with a .STATflS [Sec 3.6]. Aoy .OPES closes preriouely opened 
derices on that channel whether or not the .OPES is successful. 

Files nay be deleted and renamed with 4 .OPES hut thin is usually done 
with a *FBELE as explained In section 3.5. 

3,2,1 File Directories 

■% 

For derlces with true file structure [UTn* DDn, CUT, CIO, COM, and SYS]* a 
file directory of the device my he read hy tryiog to input the file .TILE. 
(DIE)**. If character aade is used, a readable file directory terminated hy a 
“t and "0 results while image mode yields an actual binary of the directory 
which is de 7 ice dependent. Both block ani unit modes are available. For other 
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devices character input of this file came Mill yield the string ^KOtf-BIftSCTORT 
tiEYICEf, Attempted binary Input will fall {the .GPEtf Mill hot afclp}. 

In an ITS produced readable file directory, an by a file name 
Indicates Chat the file Is Inaccessible* This nay be due to the fact that It 
Is Just than being Mrittea or it may have been deleted Mhlle open for reading 
and will vanish when closed. An *!" by a file naaa indicates that it relates 
to a person at that time logged In. 

3.3 The Translation Table 

Entries in the translation table aay be made or doIatad by any procedure 
and have effect only at .-OPEN Use for the procedure making the entry and its 
inferiors. The entry consists of the following: Cl] the [MAKE and JflAKE of 
the procedure sating the entry, (£] the JrtiiME of the procedure it is to apply 
to (means all JSAME's), {3) whether it it to apply to input, output, or 
both, C4) whether its resultant la to be considered final or be retranslated, 
and (5) the from, and to device and pair of file naues, where '"*"*£ In from 
positions mHtch any device or file name and "^"s In to positions Indicate no 
substitution. 

At .OPEN time all entries in the table are examined to see if the device 
and file names Of th« .OfER and the ITUMB and JitAME of the procedure aiecuting 
the .OPSl natch tEisa, If no and the procedure which made the entry is the sane 
or superior to Che procedure executing the ,OPE’{* the substitution for device 
and file naaes specified by the entry Is made and unless prohibited by the 
entry this process is repeated* Should eight successful and sequential 
translations be aade the ,0?3tf will fail and no further attempt will bo made to 


translate 
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3,3,1 The -TSAIS TO 

This ays tea call (-CALL 2.) is expects! to point to a three word, blofils la 
the 3 ftM manner as a *OPM [Sec 3*a]* It normally skips and returns with the 
block replaced to Its translation [the black pointed to by a ,0PEt is never 
ohangel by tbs eiecation of the *0PEiI)* If too msay levels of translation are 
re^nirel it will not s'cip and the block will be unchanged. 


3,3*2 The .TUMD TO 

This system call (-CALL 3*} aakes new entries in the translation table. 
It is assuied to point at an eight word black as follows; 


DXAKB jurat t be the MANS of procedure making and subject to entry 
JIAH£ ;JliAME for procedure subject to entry 
AfHHiDSn. ;4.9 * 0 ^ retranslate, 1 atomic 
;3.£ * I => output, 3*1 - i -> input 
jpEVl ■= from device 
mi jfrom file names 

m 2 

tto device 

mi | to file names 

nzz 


Before trying to insert a new entry in the translation table, this system call 
emulates a -TfiHDL pointing at the sane block. If a ,'TSASAD Is successful in 


creating an entry it skips. 
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3,3,3 The ,TRm tfUO 

This system call [*CALL ?*) deletes entries in the translation table arid 
norcoally ‘points at an eight word block Identical to the one which was used by 
the corresponding .'ERASAD. It skips If successful in deleting an entry. It 
also has a special for* where the first word of the block is zero (not a 
possible UflAME), In this case all entries previously made by the procedure 
doing the .TRJTDL relating to the JHAHE In the second word of the block art 
deleted* This special fora always skips and does not exaiine the renainias six 
words of the block. 

3,4 The JDT HI10 

All actual data transfers to or from devices being handled via 
Input-output channels are initiated by *tOT's* The accumulator field’of a ,I0T 
should contain the number of an input-output channel that has been set up for 
transfer in a particular mods between the procedure and a particular device by 
a successful *OP3T [Sec 3.2]. If the channel has not been .QPZH'ed the 
procedure will pensive an input-output channel error interrupt (a class two 
Interrupt [See 5,205, The effective address of a ,10T la used somewhat 
differently depending on whether the channel Is open in unit or block lode. 

For unit mode the effective address points to a word to be written from or 
into* For character unit modas the character is right Justified and the rest 
of the word Is ignored, on output and zeroed (except as mentioned in section 
3.4*15 da input. Some devices, which are classified aa input, use the contents 
of the effective address as an argument to determine whnfc they win store back 
[see device* I«X, FID, and KfU), 
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Block modes aliaya read or write a contiguous block of words. Tbe 
oo at eats of tbe ef fee life address of tbe *ICT is Interpreted as baviag mimic 
toe length of toe block in, Its left half and tbe address of tbe first word in 
its right haif* Block anode nornally treats each word id tbe block Identically 
to tbe correspoodiog unit mode except that block character modes pack fire 
characters of seven bits per word left adjusted* The block pointer word 
pointed to by tbe *101 Is advanced “3 tbe transfer progresses ao that if it 
completes the lefl half will be zero and toe right ball will point to one 
greater than tbe last word processed. If a procedure Is interrupted ont of a 
block mode *IQT the pointer word will reflect the progress of the transfer when 
it was interrupted* 

Block character Input-output froi sow devices inanely Tna* TTTf, COD* LPT* 
FTP* PIT* and FIR) which are naturallj one character at a time is limited to 
blocks of length 7777? words or lass and tbe lop three bits of the pointer word 
are used during tbe transfer as a character count* 

When a *1D1' returns to the user without causing an input-output channel 
error* tbe transfer it requastaA will have been completed for unit mode input 
or output or block sole output* For block mode input* the count ia tbe pointer 
word will indicate tbe amount transfered wnicb nay be less than that requested 
if an end of file is reached [Sec 3,4-1]* 

3.4*1 Tbe End of £lie Condition 

For dasices on which tbe and of file wnils reading condition is aaaningful 
It is signaled to the user in various u&ye ;iepehdihg on tbe transfer mode* For 
character devices in the character at a time node a "c will he rend with the 
left half of the word read into set to alsus one* la block character mode the 
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last word will he filled out with "c r s, Usually the pointer word Will not have 
counted out a a the end of flLa did not occur on a block boundary* For word 
devices, the user oust normally determine the logical end of fils from the data 
beins read although physical end of ftia is da tec table in block mode by the 
lack of advancement of the pointer word. On sons devices, attempts to real 
beyond an end of file will cause the input-output channel to be anfanatically 
*C-L03l'ed [Sec 3,s,l] end further -t-DT's win cause Input-output channel errors 
(class two interrupts [Sec 5,2]), 

Vhea packed characters are being real from a word daTice the physical 
block is normally filled cut with “G's but coma older files cm DEC tape [Sec 
4.1] are filled out with the character whose AS"II value is 141 The eM 

of file character for a particular file can be determined after the file has 
been Opened by putting the number of the input-output channel It is open on in 
the accumulator specified by an ,BQrc QUO {/)PER SO), ThU channel number will 
be replaced with the end of file character for that channel by the execution of 
the *E0FC* 

3,4,2 The Device Full Condition 

Attempted output on a full file structured device tUTn* DDn) results In an 
Input-outpul channel error (a class two interrupt [Sec 5,2]} for the outputlng 
procedure. This Interrupt will occur for the *IQT that failed in such a way 
that It oay be successfully resumed If the procedures interrupt routine or some 
other procedure deletes material from the full device* 
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3.5 The ,F02L 3 ffUO 


The systez call ,FDEl,E [,CAlL It,) is used for deleting ani renaming 
files. It points at a fire word block which for the three types of .fDBLE's, 
contain the following! 


[file delate 

p DEt? [device on which to find file 
FNl [naies of file to he deleted 

m 2 

0 ;aero 

[un examined 


[normal file rename 

-,,D£'J [device Oh which to find fils 
mi [old file hazes 

mz 

F*21 [new file names 

FH22 


irenaas of file while open for writ ini 
[uqexamined 
0 j zero 

CHUUM. [Channel on which open 
Fill [new file names 

FS2 


A *FD£E§ Is Internally treated as a ,0P2^ pointing at a block with the sign bit 
on tn the first word [-Sec 3,2] except that It does not also result in a ,CLOSE 

tm 

being executed on a channel, A ,FD£L6 on a device that is not truly file 
structured has no effect but skips as la all successful effective .FDELE's* If 
a ,FDZLE does aot skip the reason for Its failure may be determined with a 
,STATUS on channel zero {Sec 3*6]* 
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3*6 The HIATUS UUQ 


The acc’jauUtor field of this system call is the number of an input-output 
channel whose status word replaces the centalta of the effestive address of the 
UUO* This states word is described in detail by the tables helew howeear its 
general compel Ulan is as follows; the left half relates to the channel, and ts 
set by falling. .GP£Ts, failing *nn£L£'s and input-output channel errors! the 
right half relates to the device. if any* open on the chans! and the state of 
the transfer between it lad the user. 


Mt{*J leaning 

1*1-1.5 ITS physical daw ice cod* <(sse table below)* 
i*7-l*3 Mode la which device was opened* 

2 *1 1 buffering capacity empty* 

2*2 1 buffering capacity fall* 

2*3-2,9 Device dependent, 

3*t-3*& Set by filling .GPEfl's and *PDEl*E's ( see table below)* 

3.7-3*3 Set by interpreted display [Sec 4,111 input-output channel errora 
(gee table hetaw)* 

4*1-4*5 Set by non-display input-output channel errors (sea table below)* 
4*6-4*3 Zero* 


The fblOWlng U a table of ITS device Codes {note that the 40 hit Indicates 
that the file oa.nes used are significant and the 2Q bit Indicates a software 
dev Ice)t 


Code 

1 

2 

3 

4 

5 

6 
7 
10 


Symbol Device 

Tnm Teletype (XSR 35/37)* 

Torn SJ3 display and keyboard* 

LPT Line printer* 

TID Old vidlsector I TIB ), 

IN D New Tldtaeet&r { TfC ). 

PLT Calcoap plotter* 

PTP Paper tape punch. 

IKX Input anUiplsKor (A-D). 
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11 

OMS 

Output multiplexor (D-d)-* 

12 

m 

Paper tape reader* 

13 

MS' 

DEC 340 display* 

14 

IDS 

Interpreted display. 

13 

COD 

Mora# code transmitter* 

21 

m 

Hull device. 

41 

DTn 

DEC tape* 

42 

DDo 

Data-dlsfc. 

SO 

5SR 

A not Immediately inferior procedure. 

SI 

USR 

An inferior pro cedars. 

52 

CU 

Core Unit use device* 

63 

CLO 

Core lint open device. 

64 

- 

The directory device [Sec 3*2*1]* 


The fallowing is a list Of the codes left ^ar falling ,0FElt'e Odd *FP£Lf'h; 


Cole Reason 

X Ho such, device* 

2 Wrong direction* 

3 Too many translatinns, 

4 Tile not found* 

5 Directory full. 

6 Device full, 

7 Device not ready* 

10 Device not available* 

H Illegal file came* 

12 Mole not available* 

13 ?lte already exists (attempted renan#h 

14 Dad channel number (attempted open renaa#)* 


The folioJinS are th# error codes left by the 340 interpretive display 
routinesi 


Code Meanins 

1 Illegal scope mole, 

2 Scope hung* 

3 More than 23 DD words scope buffer. 

4 Memory protection violation* 

5 Illegal scope operation* 

6 Memory protection violation an DDL pointer* 

7 Illegal parameter set* 
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The following are the non-display laput-output channel error codes; 

Cole Meaning 

4 flon-esUtant eub-4jTice {such as 3HX channel [Sec 4,9]), 

5 Ov*r ,IOPOP [Sec 3*7*2], 

6 Oyer *IOP«SH [Sec 3,7*2], 

7 Channel does not have a procedure open on It* 

3 Channel not open* 

9 Define full, 

3,7 The Input-Output Channel Push Down facility 

for greater flexibility in input-output than that a?ailabia with the baa1c 
input-output channel system [Sac 3,1], a facility Is profiled whereby a Halted 
nuaber nf input-ouput transactions nay he stored for later resumption, 

Meanwhile the channel they were bains effected on nay be otherwise utilised, 

3.7.1 The .lOFtlSH and ,I0TOP UUO'a 

These Instructions treat input-output channels as the POSH and POP 
instructions [ftef l] do memory locations, A channel may be dlQPUSI'ed 
regardless of whether It 1 b open or not mod any transfer In progress on It will 
he inacoossable until the slot occupied by the information pushed Is *I0PQP'ed 
into a channel [possibly different). The error status and *ACCESS [Sec 3,3*5] 
pointer for a cha&nel are also correctly stored and restored, Executing a 
*I0P9? into a channel first closes the channel. Each procedure's Input-output 
channel push down list [App C] has apace for eight antrias. 
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3,7*£ The .30FDI tRSO 

This system call (,OPER 57) is intended to reset a pro-cad (ires input-output 
channel posh down list. Entries 02 a procedure's input-output channel push 
down list actually contain the number of the channel that was pushed to produce 
the entry. This information is used only W *IPPDt whose eiecution is 
equiralent to the number of *I0P0P r 4 [Sec 3*7,lj equal to the number of entries 
in the procedure's input-output push down list and which .I0P0P each enty back 
into the channel from which it was •IQPOSff'fti* 

3.9 Miscellaneous Uniform Ioput-Output Related System Call 9 

The folowlag system calls relate to most or all devices handled via 
input-output channels. 

3,3a The *CLOSE UUO 

This system call (.OFEJi 7) closes the input-output -channel whose number Is 
in its ftccoaulator field. Executing a aOT on the channel Without reopening It 
will result in an Input-output channel error* For devices with true file 
structure it is at close time that a file with the same name as one being 
written is deleted* 
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3*3*2 The *5tESET 000 

Tbit* system call (*OPBR 37) it Intended to reset arete* boffer pointers so 
that buffered data an ea input-output channel (specified by the accumulator 
field) will be ignored* It has not yet been implemented for DBG tape or disk 
transfers and is also Ignored by devices for which It is not meaningful [IKX* 
OMX, TIB* and STD)* 

3.3*3 The *IT¥IG 000 

It it frequently desirable to examine the characters of an incoming stream 
at the interrupt [Sec 5.3] level nf a procedure [for "gutt* features* etc.)* 
This ays ten call (*QPEEt SO) provides the facility to read these characters froa 
channels on which devices that will provide appropriate Interrupts (TTY* Turn, 
CLU* CLO) are open. The accumulator raffs red to by an .ITHC should hate an 
appropriate channel number placed in It* The execution of a a *ITYIG will then 
replace this number with the character read and eicip* If no character is 
available the *ITYIC will not slilp and If an inproper channel is specified the 
procedure win receive an illegal Instruction interrupt* 

3*3*4 The *WSKAMS 000 

’•k 

On some devices (sanely DDn* CbO and CUJ) files are actually identified by 
three file names* Two of these are specified, to the normal way [Sec 3*3] and 
the third is derived frnm the currant system name [App C] associated with the 
procedure refereccing the file. If the file is being written this will be 
written as its third file name and if being read it oust be the same as the 
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third file nail, 'Each procedure's system name is act to the UttiHE of the 
superior procedure that creates it at the time of Us creation [Sec 6*1*1] + 
,VSJUME (-OFEit 35) sets a procedure's current system name from the accumulator 
specified except that If that accumulator 3 ontains sere the procedure's SHAME 
will be unchanged* K procedure may read He SHAXE with a *SU5ET [Sec 6*5], 

3*6*5 The +ACCESS QUO 

This system cull Is intended to be used in accessing randomly addressable 
devices* i pointer is associated with each input-output channel which Is set 
to the effective address of a *aGCESS eiecuted with the channel's number in its 
accumulator field* Currently this pointer influences only the USd device £Sec 
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4. Properties of Particular Dev leas 

Properties and. ays ten call* related to particular devices handled via 
input-output channel & ate discussed below, Lower case letters ia a device n&ae 
indicate that there are several devices dietingu-l&h*d by numeric digits lfl 
their place. The phrase "all standard node*'* 1ft descriptions halo'd Implies 
that all combinations of ASCIX/lugfr, unU/bloct* and Input/output modes are 
available and that ASCII mode implies seven bit ASCII characters and iaiage mode 
thirty-sir bit binary words* 

Ac A The UTn Devices 

The devices CTl, UT2, UT3 and UT4 represent the four DEC tape drives oa 
the FDF-S, They are true file structured devices under ITS with all standard 
nodes available. Data is dynamically buffered by ITS for both input and 
output* The file directory of a tape is read in by the system and retained 
Jhan a driTe is referenced and there is no directory being retained for it. An 
updated directory will be written out on a particular tape whenever the 
directory has been changed, no files are open on the tape* and no data 
transfers are in progress on any drive. Files on UTn do not have a system name 
[Sec 3,3*4] associated with them. Directories can be excised from core only by 
the .UDISH.T OUO, ' 
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4»1,1 The .ODISHT UUO 

This system call {.DPSd ZZ), If successful, causes a DB: tape's fils 
directory to he aitciaed from core and the tape to he physically demounted* The 
drl?e muter must be In the accumulator specified by the LTLT0, Manually 
reaoving tapes Or switching drive numbers of drives for which ITS Is retaining 
a directory may result In cut of late file directories left on tapes and 
directories for o&e tape being written on another, 

k OTOIS4T strips if aol only If successful, tt will fall if any files are 
open Co the tape. If a file U opened, deleted,, or renamed on a tape while the 
UPa is belag dismounted by ITS the discount will be aborted and the tape 
relained, 

4,1,2 The .\SSIGH and .DESISK CIUO's 

These systaa calls are to enable a user to protect against other users 
accidently referencing his DEC tape to write or delete a file, Both specify 
the drive nuiheri as the contents of their specified accumulators. The ,A$SlGK 
’JiJO ships if successful and results in attempts to write on the designated 
dr Its failing unless the writing procedure has the same system name [Sec 3.8,4] 
as the UMME of the procedure that executed the *AS$IGfl. Tor a procedure in a 
disowned tree fSec 3.2,2], a .ASSKS will be treated as an Illegal Instruction, 
A .ASSIGK will fail only if the drive Is already assigned. The ,DSSIGh UUO 
snips If successful and causes the drive to be unaeelgped, It falls If the 
drive i& already un&sslgced or assigned to a different user. A drive may also 
be .BESfGS'el by a .UB1SMT [Sec 4,1,1] and the .ASSIGN' in? of a drive does not 
protect against other users dismounting it. 
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4*1*3 The *-JBLAT CUTO 

ThU 3 mem call (.OfEa 56) Is Intended for reading nonr-HAC format [Ref 4] 
(gach &* DBC format) DSC tapes* Tb* contents of the specified accumulator aust 
be a drive number for which !TS it not retaining a directory* Instead of 
attempting to read in the directory from the Upe nouatel on the specified 
drive* IfS Internally marks the drive so that thU directory may not bo changed 
(no writes* deletes* or renames), At this point a successful *0P3fl of the tape 
say he aiecuted with any file name and ail blocks of the Ups will he real 
consecutively* Thus the tape nay only ha referenced ta real the file 
containing the entire contents or to *tS3IS^I [Sec 4*1*1] it* 

4*S The DDn, STS, and "04 Devices 

The devices DDO and DOi are two Data DUk M-S disk drives* They are truly 
file structured with system names [Sec 3.3*4] aal have all standard nodes* 

Data is dynamically buffered by ITS [Sec 5*3] for both input and output* There 
file directories are read in the first tiae the drives are referenced and are 
written out whenever they have been change! and th* disks are otherwise Idle* 

The device STS is used for storage o-f systems programs mi is currently 
those files on defied DUO with system name STS, Reading or writing device STS 
caused one to reference DDO as though one's system name were momentarily STS* 
The device CQH la used for commonly used user files. In a manner similar to 
device $TS it is DPI with system pane COJUCVt* 
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4.5 The CLO aad. CLU Devices 

these internal devices are used For buffered iuterproeedure commuaicatlon. 
One procedure must open a file on device ClJ) (core lin't cpea) and the second 
must then open a file with the sums names (including system name [See 3,3,4];)* 
mode, and the opposite direction on device CL'J (core link use). All standard 
moiiea are available. For character mode transfers, interrupt level processing 
is available [Sec 3.8,3, 5.2], Each link hae a SOD word buffer associated with 
It. 

4,d The NUL Device 

This device has all standard aodes and is a high speed infinite sink on 
output and source of seres on input, 

4.5 The Tnl and TTT Devices 

Devices TOO through T04 represent teletype lines to the fdP- 6 with KSa 
35/3? r s on the other sod, Devices T15 through T2Q [the two digits are treated 
as an octal pusher) are 33 Datenet 763 terminals with a character only display 
and keyboard, [Devices T05 through T14 may soon be available for »or* teletype 
and teletype-! ike’■hardware,) Device TTf for a particular procedure la the 
console coutroling. the procedure tree it is In. All input-odtput to these 
devices is in ASCII characters and the "image" mode [Sec 3,2] has special 
meanings, 

a procedure lay not open its console by referlas tb it as Tus for the 
corresponding n and m. Only bus procedure at a time may have a teletype Open 
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as a device r ather than a console* The procedure with TOO opened at a console 
|TTY) and that actually has controls of it [Sec 4*5*1] can always selie the DEC 
340 display [Sec 4*11]* 

I mass node output to K'Sft 35/37's is my straight forward and Just sends 
the character to th* teletype unmodified, A.5CTI node differs only In that the 
character whose value is 33 is printed as a *$", other characters with a value 

Hr%.H 

less than 40 that are not format effectors or bell are printed as an 
followed hy the character with an ASCII value 100 greater, and new Une is 
simulated for a carriage return. Output to ftS terminals Is the same as ASCII 
mode output to K&ft 35/37's except for the following:: (l) all Line feeds (13) 
are ignored, (3) a "L (form feed) clears the screen, (3) an automatic new line 
is inserted if the right margin is touche 1, (4) a *_ rt , as displayed hy the 3E 
terminal* U used instead of an prefix, (5) output beyond the bottom of tbs 

output area wraps around and overwrites from. the top of the output area which 
does net Include the hotto* three lines unless the first input .QPIK [Sec 3*3] 
had the 3*4 mode hit on, (S) finally* if the output Is in image mode only* the 
character will allow ofertffitting starting from the top of the output area 
without clearing the screen or wrapping off the bottom. For all the above 
output modes, addins block mods only affects individual character processing by 
causing ^£*5 that are output to ba ignored* 

Input to keyboards (which are all full duplex) is buffered by IPS in 
relatively small fixed siae buffers. Striding a hey when this input buffer Is 
full results only in a *5 (hell) (or *V an a SE terminal) being output as 
echo. Any input wham the keyboard la not in use except [See 3,1]* is 
Ignored by ITS* Procedures way enable interrupts (class three) due to 
non-empty input buffers [Sec 5*3] and also examine the input characters at 
interrupt time with *1TTIC [Sec 3.9*3] * 
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Imase mod* 1.aput U Chirac ter Usd by no ITS supplied echo *ud *0 
modification of the character codas unless open node [Sec 3*5] bit 3.5 is also 
M( in which case lower ease £SR 3? character a are transform! to upper case 
FtSR 35 characters. 

ASCII node Input proTides echo io approximately the lias manner as 
output in? the characters U ASCII mode* Procedure output has higher priority 
than echo output* On SE terminate Input Is nOrSAllr echoed In the bottom three 
lints unless the 3.4 open made hit was on* In which case characters are echoed 
where output Is appearing except that a few characters are not echoed at all* 

In ASCII fflode Input, the charactera whose values are 175 and l?S ape Input and 
echoed as If they ware the character whose value 1s 33. Having op*n mode bit 
3,5 on has the same effect for ASCII nod* input as It did for Image mode Input. 
In general, all of the various mode hits effecting Input are obtained from the 
first Input .QPCa [Sec 3.2] executed by a procedure far a particular teletype* 
for alL the above input modes* addin-? block node results la Input until the 
block input pointer runs out or until a 3 is typed at which point the *IDf 
[Sec 3*4] haip? executed terminates as oa an end of file [Sec 3*4*2]. 

Any input or output JOT or ,OP£( executed on a TTY device while it 13 
actually helm? controlled by -Mother procedure [Sac 4*5*1] will han; until, the 
executing procedure regains the device, 

4*5.1 The ..ATTY and .Bin TJO's 

These system calls (*QPEft 11 and .OPES 12 respectively) enable procedures 
in a a Inal* consols controlled procedure tree to transfer control of their 
console between each other. The execution of either by a procedure that does 
pet have control of the consol*, because it was taken away by a higher 
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procedure's execution of a ,1>TTY* will han* until U regains control* The 
accumulator field of each mat specify * channel on which an immediate Interior 
procedure is open [Sec 4*13]* Ad *ATTT will pass control of the consol* to 
this open procedure Unless the procedure executing the .ATTf has control of the 
teletype by taking It fro® aom® deeper Inferior alone the same procedure tree 
branch In which case It reverts to the procedure from which it came* An .ATTt 
will hang instead of doing ttis above If the last character typed on the console 
was a *z» A *DTTf retrains control of the consol* froi some Inferior to the 
procedure executing it* 

Both of these calls skip if au&ceesfsi* An *AT?'£ will fall to atlp only 
if no infarlor Is open on the channel It specifies. A ►D'TTY will fail to skip 

if no Inferior ie open oh the channel It specifies or if the procedure 

executing it never had control of the console or never gave control away. All 

other conditions blocking the success of either system call cause them to hang* 


4,5.2 The ,LISTS! UUO 

This system call t^OPSH 2) is usable only on the console a procedure is 
associated with. It will hang If Control of the console [Sec 4.5.1] has been 
taien 4 way from the procedure executing it and if all procedure output has not 
been typed, it then returns with the number of buffered Input characters in 
the specified accumulator. If the procedure has never bad control of the 
consoL* or Is In a. disowned tree [Sec 6.3.2] zero will be returned. 
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4,6 The LFT Device 

A sU hundred lift* per minute Data Product*, Inc* line printer with one 
hundred and twenty print positions and sixty four printing characters is 
available for character output as levIce DPT* The ASCII iuaga mode bit [Sec 
3,2] is Ignored in ,0PEU'& on device LPT but either aingle ASCII character* or 
blocks of packed characters nay be output as Indicated by the hlocfc/uult aode 
bit. Ihe follcwins ”tran*f or (nations'' are made to the output text: [1} Lower 
case character* are a&ds upper case* {2} characters beyond the cue hundred and 
twentieth print coition are ignored* {3} format effsctors (except for vertical 
tab) are simulated &s for a model 35 teletype, thus overprinting can be 
accomplishad by using carriage return without line feed, [4} character* with an 
ASCII value below 40 other than the sinulated format effectors and character 
33, which Is printed as a are printed as a followed by the character 
whose ASCII value is 100 greater. 

Only on* procedure may have the LPT device open at one tiae hut it day he 
open on acre than on* channel, A fixed looo word buf"ffl'P Ifl p 

output to this device- 

4*7 The PL? Device 

A CalCoap model 5S5 plotter [fief 9] ia available via "character 4 ' output to 
device PIT. Available with the sane modal restrictions as the LPT device [Sec 
4.6], it it al*0 similar tc that device In that It may only be open by one 
procedure at a time but may be open on more than one channel. A fixed 300 word 
area Is used la ITS to buffer output* 
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Only tbs right mast aU bits of characters cutout to the PLT device have 
effect, The/ are from right to left as follows: (1) tssn up, {2} jsajt down, (3) 
plus 3E P {4) minus x, (&) Plus, y P {°) *ihus 7, 

4.3 The FTP and PTH Devices 

The FTP and PTft devices represent, respectlrtly, the sixty three and a 
third character per second paper tape punch and four hundred character par 
second photoelectric paper tape reader on the PUP-6 [Ref 1 ] , They are similar 
to the LPT and PLT devices [$*c 4.£, 4,?] in that only on a procedure may have 
each open at one time but that procedure cay have the device open on note than 
one channel possibly in different modes. Also output or input is buffered in 
ITS in fired areas of 20 and 100 words respectively. These davicea differ froa 
the LPT and PLT devices in that all standard nodes {Sec 4] are available and 
the following special node, If In a successful .OPEH for one of these devices, 
the 3.4 mode hit [Sec 3,2] Is on than the 3,3 sode hit is ignored, the 3,2 mode 
tit must Indicate unit mode, and all eight paper tape channels may he Written 
or read from or into the sight rightmost hits of the word addressed by each 
*13T [Sec 3,4] executed. 

4*3 The DU Device 
<* 

A multiplexed analog to digital converter attached to the FDP-6 la 
available Tin word input from the IHJt device [Ref 5* S] * Block and unit modes 
are available hut the ’ t ASCI[/Image" mode hit [Sec 3.3] has a special 
significance explained below. Each word input into must initially contain a 
number from zero to 177* This number will he replaced with the twelve hit 
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itsitelisation of the analog quantity associated with the multiplex channel of 
the same number* tf it is desired to read In values converted at each .10t 
[See 3,4] tine then device I MX should be opened ift "ASCII” node. Opening 
device IMI in "image” mode causes ITS to continuously read all input 
silltlplexor channels Into system core a ainiaum of about ten Slues a second. 
fiiMUti&K a ,I0T on. a channel opened In this manner will result in values up to 
one tenth of a second old but without the overhead necessary to road lh new 
values, Any number of procedures nay have the 1KX device open, possibly on 
different channels and possibly in different modes. Current 134X channel 
assignments are as follows! 


Channel 

Input function 


G-h3S 

Unused, 


33 

flVD iris. 


M 

flTD focus. 


35 

THU mirror. 


36 

Rhcmbcidal test table 

pot 

37 

fihombotdal test table 

pot 

40 

RLhomboidal test table 

pot 

41 

Rhonhoidal test table 

pot 

42 

Pot hoi upper left. 


43 

Pot boi upper right. 


44 

Pot bni lower right. 


45 

Pot box lower left* 


45 

■tew arm shoulder. 


47 

flew am shoulder. 


50 

flew arm Joint 1A. 


51 

flew arm Joint IB* 


52 

flew arm joint £A, 


53 

flew arm Joint 2B* 


54 

flew arm Joint 3A, 


55 

flew arm joint 3B, 


56 

flew arm joint 4A. 


57 

flew arm Joint 43. 


65 

TPS output* 


61 

Alies hand tilt. 


6£ 

Alles hand extend* 


S3 

Allas hand rotate* 


64 

Alias hand grasp. 


65 

AMP arm wrist roll. 
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m 

AMf are wrist yaw* 

57-70 

AH? ars hurlinntal high resolution* 

71 

AMT arm horizontal absolute position 

72-73 

AM? arm gwi&g hUh resolution* 

74 

AMT ar« swing absolute position* 

73-73 

AHF arm vertical high resolution* 

77 

AHF ara vertical absolute position* 

100-111 

Unused, 

112 

Joy stick X* 

113 

Joy stick Y, 

1 14-137 Unused, 

140 

Hew pot bos pot one. 

141 

Hew pot bos pot two. 

142 

Hew pot bo* pot three. 

143 

Hew pot hoi pot four* 

144 

Hew pot box pot five* 

145 

Haw pot box pot six. 

146 

Hew pot hoi pot seven* 

147 

Hev pot box pot eight* 

150-135 

Unusei* 

155 

Joy stick console pot ten. 

167 

Joy stick console pot nine* 

170 

Joy stick console pat eight. 

171 

Joy stick console pat seven* 

172 

Joy stick console pot six. 

173 

Joy stick console pot five. 

174 

Joy stick console pet four. 

175 

Joy stick console pet three* 

ITS 

Joy stick console pot two. 

177 

Joy stick console pot one* 


4.10 Hie OHX Device 


A multiplexed digital to analog confer tar on the FHP-S is available via 
tforl outsat to the OMJt device [Hef 5, 6], ElDok and unit modes art available 
and the "ASCII/lnage^ mode Mt [Sec 3.2] Has a special significance explained 
beloJ* Each word output should have the desired channel number In lilts 4,4-4,4 
and the vaLue to he converted In bits 4*3-3,1, Thus channel numbers range from 
wro to 7? and values from zero to 7777* These output channels decay 
exponentially with eone large time constant so ITS stores the current desired 
value for each channel and outputs them every half second as long as the D^X 
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device is op?n by some procaduro* Chitput In ASCII node tunedlately effects 
tlift channel as well as stories a Talua to he output periodically. SllsIttlT 
less overhead occurs In "image" sola which only stores a value in ITS and W 
have no effect for up to half a second* Any nusher of nears nay hurt the OKI 
deyice open, possibly on more than one channel and possibly in different nodes. 
Current CWX channel assignments are as follows 


Channel 

Effect 

0-11 

Unused. 

33 

!ITO iris* 

33 

ITS fddus. 

34 

STD mirror. 

35-33 

Unused. 

54 

arm shoulder. 

55 

Hew arm shoulder. 

56 

flew arm Joint I A* 

5 ? 

lew arm joint IB* 

eo 

Hew ara joint 2 A, 

61 

Hew ara joint 2B* 

62 

Hew an joint 3A. 

55 

Hew arm joint 3B, 

64 

flow arm Joint 4A. 

S3 

Hew arm joint 4B* 

53 

Allot hand grip. 

6? 

Ailea hand tilt. 

70 

Ailea hand extend* 

7i 

Alloa hand rotate. 

7£ 

AHF arm wrist roll 

73 

AMF arm wrist yaw. 

74 

TDR hortiontal. 

75 

AHF ar* horizontal 

76 

Mi? are vertical* 

77 

AMT arm twins.* 

The BIS and IDS Devices 


The SBC 340 display [Raf l] differs significantly froi all other devices 
usahle in ITS. In order to maintain an Image On the display it is necessary to 
repeatedly output to it a list of display words. This list nhst be stored in 
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inaLri memory and the various weans of awing the dispaly may ^ divided Into 
lUose that naintain this list in s/s tea aemory (discussed U this sect to a) and 
those that allow the list to he maintained In the users core tU£S [See 
4,11*1]» 

Only one procedure at a tine may use the 340 digplay and lii only one of 
Its three nodes [at symbolic device DIS, as symbolic device IDS* or via the 
,DSTART add *D5mi OT'sh If the display Is free* any procedure may seise it 
hy eiecuUng a proper *OPBt on devices MS or IDS or by executing a .DSTART or 
.DSTETL UUO. If the display is In use. however, a procedure will succeed in 
auy of the above OilO's only if It is the procedure that has the display or it 
has control of device TOO as a console (Sec 4*6]* If the second case applies, 
the channels* if any, on which the other procedure had the MS or IDS open win 
he acidified to the corresponding (block or unit) ’flu device [Sec 4,4] output. 
*CLQS3 r los (Sec 3*9*1] an input-output channel on which device DlS or IDS are 
open is the same as executing a -DCLOSS [Sec 4,11,3]* 

Tii* MS symbolic device allows the user to output single or packed blocks 
of ASCII characters in ASCII mode and single or blocks of 340 display list half 
worda [Ref i] in image mode* This device may he open on more than one channel 
at a tue in possibly different modes* If the User outputs characters and then 
halfwords, ITS will automatically Insert intervening Items to cause the display 
to escape to paramerer mode* If the user outputs half words and then 
characters, ITS assumes that he has inserted items to cause the display to 
escape to parameter mode, A display list produced by output to the MS device 
will start by setting the 340 display intensity to ?, its s and y coordinates 
to zero and 7000, and Us scale to one larger than the 3*4-3*5 field of *OFES 
mode bits [Sec 3*£l used unless that field U 3 in which case the scale Is set 
to sera* tines of chsr&cter output that astand beyond the right edge of the 
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screen will wrap around and continue fro a the left* Lift* a of chiral ter output 
that sitend beyond the bottom af the screen similarly continue fro* the tap* 

The amount of display information created by BIS output nay not exceed 3330 
words.. Af ter that* further output is ignored. The stored Information created 
hy output to the BIS device nay be deleted to accept new information by 
outpuUng a *T fl( i 'l (fora feel) character. In the latter case, this action 
will be delayed for a few seconds. 

The IDS symbolic device allows the user to use a aeml-ldeallaed display. 
This device is known as the interpreted display since the user writes 
Instructione" to be executed by a display processor which are then interpreted 
by ITS Simula tins the processor and creatine a MO display list to actually 
display. H Ths IDS device nay only be opeaad in Unit output code ani what the 
user outputs to it is the location, in the user core image* for the display 
processor to start "uacttlW* Almost all error conditions encountered during 
this "execution" cause Interrupts to the user [Sec &*£!« The simulated display 
processor has a push down list facility with Its push down list pointer in the 
user's location 43. The information to be sent by the .EOT'lag [Sec 3,4] of 
each starting location to the. IDS device is normally terminated by over popping 
by the display processor. The information stared by the IDS device Is 
currently limited to 2000 words. If the 340 display la being run by the IDS 
device when a .EOT is excuted on It, the display will stop and the stored 
information will fie over-written* If the 340 display le not being run* output 
fro® simulation la appended to that already present. Whether the 340 display 
la started at the end of the simulation Initiated by a .EOT Is determined by a 
display processor paraseter that may be set during simulation. 

Instructions for the IDS simulated display processor are thirty-six bit 
wards interpreted as five left justified ASCII characters If nit 1*1 is sera* 
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If tH 1*1 ia a on*, Mts 1 *4^1.6 are interpreted as the follotflns ccrnmnds; 


1 

2 

3 

leas th, 

4 

5 

6 
7 


1*4-1.6 Coaaanl Other fields 

0 Illegal, 

fo-lat, 4.5-3,4 Y, 3*3-1 *7 X, 1*2 intensify, 

Ral sector* 4.9-3.4 Y, 3.3-1.7 X, 1.2 intensify. 

Increment* 5 left justified $ bit fields each: 1,1-1,2 
1,3 Intensify, 1,4-1*6 direction (cloctorflea froa rtrttull. 

Sea betov* 


4bs rector* 
ElLegal* 
Illegal* 


1*7-1,9 subcommand function. 

4*3-3,4 Y* 3.3-1*? Jt, 1,2 intensify. 


1,7-1*9 Function Other fields 

D Sllesal* 


1 

POSftJ, 

4.3-3,1 

2 

POPJ, 

4.9-3,1 

3 

JRST, 

4,9-3,1 

4 

See belev* 

2,.3-2,9 

5 

PUSH. 

4,3-3,1 

& 

POP, 

4.9-3*1 

7 

Illegal, 



address, 
address, 
adlr ess* 

parameter tn set from 4,9-3,1* 

add re s s. 

address. 


2*3-2,9 Parameter 
0 Illegal. 

1 Start mode (noritefC naans start after *I0TJ, 

2 Character scale, 

3 increment scale. 

4 Vector scale* 

5 All scales. 

6 Coordinate of left ed*e of displayed area. 

7 Coordinate of bottom edss of iisplyej area. 
10-?? Illegal* 


4,11*1 The .DSTtST and .BST^TL CUO's 

These ifUO'd (.CULL 10, and ."ILL 12* respectively) enable the user to 
dispLay lists that are in his core LuA^ta, The execution of either attempts to 
seUe the 340 display and skips only if successful* 
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Jd .BSTAHT should point at a Location that will always contain sitter a 
ELtO [aef l] type output pointer, If one block of data is to be displayed, or 
tb 9 first word of a linked list of display blocks* In this linked Uat* the 
tight half of each entry points to the next entry, or, if s*ro* Indicates the 
end -of the List* The left half of each word should he post tire and ta a 
pointer to a BLKO pointJr or is Ignored If tt is aero or points to a inro word* 

♦DStWL differs frOh *DSmT only in that, if it is used to display a list 
of 010 ohs, the left halves of ib linked list words are Interpreted as point Us 
to the ward after not a BUO pointer hut a regular block node output pointer 
pec 3,4j . ‘ 

4.11*2 The *LTPSI iKJO 

The 340 display is sculped with a U&ht pen that causes a hardware 
interrupt when the light intensity It is eg increases suddenly as when a spot Is 
displayed under it* The display also stops when this occurs and Its current 
coordinates can be read in by the PDP-3* Th* user may enable software 
interrupts {class three) to his procedures when the light pen is aeon and he 
has the display seised (Sec 5*2]. 

This syetaa call {*CALL 14.) turtles the user with the display seized to 
read Information about where the light pen has been seen and the state of the 
current transfer to the display. Ratalt* are returned U the contents of the 
effective address and following five locations* The contents of the effective 
address also acts as m argument* If hit 4,9 is Mro the rest is Ignored* But 
If bit 4*9 is & one then bit 3,1 will cause the ,tTPB1 to hang until the light 
pen has been seen at least once and bit 1*1 will be need to set the multiple 
sight tug node* If this anode is on, the light pep nay be seen many times while 
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a display block la displays*! once* If this node is off {icru) the 11 pen 
may be seen only oace and Ignored thereafter for each display of a display 
block* 

The six words returned to the user are as follows? (1) the actual word 
Cmi'al [Ref 1] from the 340 display at the tine of the last light pan 
Interrupt, (Z) the number of time* the light pen was seen since the last *I.PJR* 
(3) the sub of the y coordinates at the points the light pen was seen slice the 
last ,1®, (4} the corresponding su* of t coordinates, (5) the current linked 
list pointer* and [3) the current BLXO pointer* 

4*11*3 The *DCL0S£ ’JUa 

This gjatan call [.OFfia 15} releases the 340 display if executed Iff the 
user who has the display sailed* closing any channels on which U is open* 
Otherwise it does nothing. 

4*11*4 The *h5TOP ’JUO 

This system call (*QP£fi 13) stops the 340 display* hut does net release 
It* if executed hy the user who has the dUplay seized* Otherwise it dote 
nothing. It is Intended for use in conjunction With the *ESTART or *h3TRTL 
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4,1a The USA Device 

Tie USR device as tail ly rep re neat a prase lares, A successful *0P£3 [3a c 

3.2] executed on defies USA will either create a new procedure [Sec 6.1,1], 
attach a disowned proced ire tree [Sec 6.1.2], or simply associate with the 
input-output channel on which it was executed an existant procedure, The file 
names are the UHaMB and JliAi4£ of the procedure being .Or'EH'el, Only Lined late 
Inferiors may he JJfla'td to write Into hut any procedure may he examined. If 
an inferior procedure has been opened, it may he destroyed by a .UCLQ3E [Sec 
6,2,1] hut will he entirely unaffected by a ,CuOsE [Sec 3,7,1] executed, on the 
channel. The same procedure may he open on more than one channel of its 
superior, possibly in different modes. It is at first .OFIlfl line that an 
Interrupt bit [Sec 6,1,3] is assigned by ITS to & procedure, Tbs number of 
inferior procedures a procedure may have Is currently limited to eight because 
that is the allowed number of aniine inferior procedure interrupt hits [Sen 

6 . 2 ] , 

The 3,3 mode bit [Sen 3,3] is ignored Ln ,OPEA's cn devtca 6SR hut both 
bloch and unit uolas are araiable, Executing *IGT'a on channels opened on 
device USA results in the transfer of a thirty-six bit binary word or words 
between the procedures, Tbe location in the -QPEM'ed procedure of the first 
word to be transfared Is specified by tbs .ACCESS [Sec 3,6,6] pointer 
associated With the input-output channel on which the transfer la occuring. 

Each word transferal advances the appropriate painter by one eTen in unit node 
which ITS treats internally as bloc As of length one. An attempt to read u word 
beyond the core allocated [Sec 5,3] will result la a claas two interrupt [Sec 
5,2] hat in n similar attempt to write (po&aible only for an immediate 
inferior) ITS will attempt to extend the procedures core image and an interrupt 
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Mill result only If more core is unobtainable. 

Executing a *EI£EI [Sec 3*8*2] an a channel with an inferior procedure 
opea oa it la equivalent to eiecuUag a .GCIOSE and then & .QtEK to recreate 
the procedure [Mitt reset variables, one 2000 word block of cleared, core* etc*} 
but with lose overhead* 

4.13 The TID and STD Devices 

These devices are somewhat similar Eo the I Hi device [Sec 4*9], i a that 
they lay be oped by any number of procedures, hare block and unit modes, and 
"functional" word input where the quantity read is a function of the contents* 
Tney differ in that tne A50ll/i*ufi& ,OF£h mode bit [See 3*2] is ignored and 
tney represent vidissectors* The initial contents of words input into should 
be the coordinates of a point In the fieLd of view of the particular 
vldlssector at which it is desired to know the light intensity* This contents 
will be replaced by a fuactlca of sail intensity* The etact fora of these 
words and the use of any device dependent .OPEN, mode bits [Sec 3,2] is listed 
in the table below. 

I tern VID KVD 

X £.3-1.1 4.5-3*2 

T 4*3~3*L £.6-1,2 

-k. 

value 1,8-1.1 {reciprocal of intensity) 

4*9-3*3 (normal!ted floating reciprocal Intensity) 
£*1-1*1 (integer logarithm reciprocal intensity) 
(too 400 3.1 (overflow) 

dark) 3.2 (die cut off) 

dead *1 4000000 

modes 3.'6-3.4 (340 intensity} 
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3*5-3,4 ■(confidence level) 

3*S-3*6 (dim cut off level) 

The deflection signals for tie VILi device cone fro* the DEC 340 display 
[Sec 4.U] whose utfl will be degraded by using; device ViU T 

4*14 TbS OOB JldViM 

To is is a chare ter output device that [Lay he used In block or unit aode 
but not any fern of Imago mode and not by acre than one procedure at a tide* 

It causes transmission of low power IN Morse code at a frequency Just off toe 
bottom of the FK broadcast band* Characters for which there is no standard 
Morse code (such as line feed) are ignored except that the speed Is set by 
characters whose value Is greater than 137 to approximately seventy five 
divided by the difference between the character vaiue and 137 word* per minute. 
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5* The Procedure 

5*1 Philosophy and Organisation 

Phs use of ITS Is entirely procedure oriented, Almost all system actions- 
are caused by trapping Instructions [Sec 2,2j App A] executed by user programs 
that are hterarchiaUy organised [Sbc 6*1]* A large muster of variables [App 
C» See 5,5] are associated with each procedure by the ITS system* These 
varlables are stored in the system and do not impinge on the uger'a core Image, 
These procedures are run for short fixed lengths or tine or until they 
become tin run stable (whichever coa.es sooner)- in an order determined by the 
scheduler [Sec 5,4), The scheduler also handles software Interrupts to the 
user [Sec &*2 t 5.4], ¥hea in execution, user programs run with the PDF-6 In 
user made [Sec 2.2,2} which enables protection and relocation hardware that ITS 
sets in acoriance with the length [Sec 5.3] and location Iti absolute neaory of 
the particular procedure's core Image, 

The following are among tb* BiiTFiQtasea of this storage of uaer variables: 

[1] Ho effort by a user's procedure to randomlje Its cure image can effect 
system variables related to the procedure and thus erase evidence of system 
malfunction or lack of malfunction* 

(2) A procedure's core image may he easily swapped out without signifleant 
reduction In Information concerning it of Interest to the system or the 
necessity to retain some portion of it. 
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5*£ yaer Interrupts 

ITS proTiles software implemented interrupts to the user program similar 
to the hardware Interrupts It receives* Only one level of Interrupt is 
simulated but this maitea little difference due to the ease with which the user 
can Inhibit or enable various types of interrupt [Sec 5*£*i] and nay also 
re-enable interrupts without tamedlately or ever returning to the location his 
program was interrupted from* 

Sach user has in system memory two Interrupt enable mask words, two 
interrupt request words, and a flag indicating interrupt level status [App C] * 
Various conditions that can cause interrupts are assigned bits In these 
interrupt request words* These conditions are divided Into three classes 
according to severity, Class one conditions, the most severe* can net be 
enabled* They always cause the ’'interrupted* program to be stopped and Its 
superior procedure to receive an Interrupt, Class two conditions are of 
moderate severity. They aay be enabled to Interrupt the user but If they occur 
while not enabled or while the user's interrupt level flag indicates he is 
currently processing an interrupt* he will he stopped and his superior 
procedure interrupted* Class three coalitions are the least severe and may 
also be enabled to interrupt the user* ifhile not enabled they have nc effect* 
If enabled and they occur while the user's f1 ag Indicates he U free to receive 
Interrupts he will he interrupted but if the user's flag Indicates he is net 
free they will be stored in the Interrupt request words to be presented to the 
user as soon as he allows* 

The particular hit used in an immediately superior procedure's second 
interrupt request word to Interrupt it when a fatal error occurs in its 
inferior Is the bit assigned by ITS to that Inferior at the tine it was created 
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[Sec 6.1,3}. 

'rfhsn coalitions that would cause a procedure's superior to he interrupted 
occur in a Up Level procedure cue of two things i*T happen. If the proceiure 
tops a. console controlled tree* & new S/iCTTM will he Loaded (as io section 2.i) 
and all Inferior procedures WILL oe lost, tf the procedure tops a disowned 
tree [Sec 6.2.2] it will he immediately stopped and When nest attached {Sec 

6.1.2] by a job tree the attaching procedure will he appropriately Interrupted. 

ITS determines that it should actually interrupt a procedure at schedule 

[Sec 5*4]* .DISMISS [Sec 5.2*2]* or *llFlS£T [Sec 5.2*3] time If there are 
corresponding hits on in one or both of the procedure's interrupt request and 
mast words. ITS examines the contents of the procedure's location 42 to see If 
its direct address (indexing aod indirect addressing Ignored) is hetween 20 and 
6 less than the top of the user's care image Inclusive* If not, the user 
receives a cues on* interrupt for a bad location 42. Tf so* the user's 
appropriate interrupt^word (first word has higher priority than the second), 
containing bits on for interrupts the user It being presented with, is placed 
in the word directly addressed by the user's location 42 and hit 4.§ of that 
locatiop is turned On if the second word was stored, the interrupt request 
word stored Is then cleared to racelie future interrupts. The user's Interrupt 
level flag is also set to inhibit further Interrupts. Finally a is 
siaulated to a Location one greater than that In which the interrupts were Just 
stored. The normal manner to return from an Interrupt is with a .DISMISS [Sec 

5.2.2] . 

The following it a List of word one Interrupt bits: 
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Bit (s' Class 

1.1 3 

1.2 1 

1.3 1 


Condition 

Character typed at Console [Sec 4.5.1]* 

"z typed [Sec 2a]* 

Bad location 42* 


1.4 3 

1*5 2 

1*6 Z 

1*? 3 

1 *& 1 

retrieving .U5RT 
1.9 Z 

Interrupt use the 
2.1 Z 


A3 overflow [Hef 1]. 

Display list memory protection violation [Sec 4,11]* 
Illegal instruct Loo, 

System going down In 5 minutes [Sec 7.5,2], 

.TALUS executed [Sec 5,3, l] (Note that a value 
is available [Sec 6*2*3],) 

Input-output channel error, for more exact cause of 
.STATUS UUO [Sec 3,5], 

Memory protection violation os reference to inferior 


procedure [Sec 4*12], 


2*2 

1 

.MEM derated [Sec 3.3*2]* 

2,3 

1 

Return fro® single Instruction proceed [Sec 7,7], 

2.4 

3 

Slow clock [every half second). 

2,5 

2 

Memory protection violation [Ref l]. 

2.6 

Z 

MAR interrupt [Sec 7*4], 

2*7 

3 

light pen [Sec 4,11]. 

2*3 

3 

FDL overflow [Ref l], 

2,9-4,0 

— 

Not used. 

4.3 

— 

Indicates re&t Of bits to he i&t*rprlt«d as below 


In the second word af interrupt requests, bite 3*1-3*5 represent inferior 
procedures [Sec 6.1*3] and bite 1,1-2,7 represents input^output channels [Sec 
3.1] with 1*1 for channel tern. Interrupts occur from Inferior procedures as 
described above for class one or two Interrupts to the Inferiors while an 
Input-output channel will try to interrupt if there is buffered teletype [Sec 
4*5] input or character mode core link [Sec 4.3] input on the channel. These 
buffered characters a&y be examined at the Interrupt level with .ITYIC [Sac 
3.3,3]. 
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5.3.1 The *SETh£ 5K and *$£TH3 m' 6 

These system calls (*QPtS 4 and *0PER 5 respectively] provHe the 
mechanism by which the user can set tils la ter rapt enable mask words. These 
oasic words contain sero whenever a procedure la treated or lias a *R£$1T 
executed on it [Sec 3,3*3, 4.13]* Since the second aask word will pot be 
useful to many single programs, the first of these call* la provided to set 
only tbe first word fore the accumulator it specIfits* The second will set 
both saah words from the specified accumulator and the following location, 

d procedure may eiaalne Its interrupt mask with the *5U3Sf UlTq [Sec 5*5]* 
In general a *SUSBT will not retrieve what & procedure atteaptes to set In Its 
first mask word as bits 1*3, 1*3, 1*3, 3*3, and 3,3 (the class one interrupts) 
will not appear set, 

5*3*3 The .DISH!5$ UUO 

This system call {.CALL 1,) provides the norial means to return to an 
interrupted routine. It stnultsneously re-enables interrupts an-d transfers to 
the location directly addressed by the contents of Its affective address which 
Is normally but not necessarily the pseudu-JSR word stored by ITS as It 
simulates an Interrupt* If there are pending conditions ip the user's 
Interrupt request Voris he win be imaei lately re-lnterrupted. 
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5*£*3 The *n?l££T UtfQ 

The nser may arbitrarily inhibit or suable all interrupts to tils prolan 
by means of this aystea call LOPE! 36} which stores the conteats of the 
accumulator specified Into his interrupt level status flag. Tbe tero state 
Inhibits Interrupts while the sinus one state enables them. If there are 
pending conditions In the user*a Interrupt request word when he enables 
Interrupt ha will be interrupted immediately* The user a a/ examine his 
Interrupt level flag by means of the ,5AJ5£T (JLT3 [Sec 5*5]* 

5*5 The Core Allocator 

An internal map of the status of every 2QQG word block of memory exists in 
the system and is main tat itfci by the core allocator* The majority of the 
complexity of the core allocator is not due to maintaining this table hut to 
the actions It must sometimes take to relocate input-output buffers and other 
occupants of core when a procedure wishes to expand* The lack of sagalus on 
the FBF-S mates it sometimes necessary to "shuffle* core to make a sufficient 
contiguous block. 

Each 2000 word block wist, except for two transient states, he devoted to 
one of the following uses; (l) part of a procedure's tore lma?e [ITS code and 
variables appear ffs core allocated for the system job [Sec 7*5]}. {2} a disk 
buffer or directory [Sec 4*2]. [3) a display buffer [Set 4*11]* [4) unused, or 
[5) further subdivided into 200 word blocks. These 200 word blocks are used 
for Core link device buffers [Sec 4.3] or for DEC tape buffers or directories 
[Sec 4,1], 
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k procedure may request kore or Lass -so re by mean* 1 of the *COflE JUO {See 
5,3,1] -and determine its aeaory bound wlth-cmt asking protectLou violations with 
the *SiJSET JUO [See 5*5] * Other than the .GORE WO a procedure's memory bound 
may be affected only by its destruction, when all blocks in Its core Image are 
aarfid free, or a .USE? [Sac 6.^.3] or *10? on device (JSft [Sec 4.12] executed 
by its immediate superior. 

5,3.1 The .COKE (130 

This system call (.CALL 6,) requests for the procedure erocutic? it as 
many SOOfl word blocks as the Talus of its effective address oicept that if this 
value is sere it will b* treated as if it were ope. If and oily if the *COS£ 
is successful it skips, Only a ,C0RE to acquire more core may fall. If U 
does and a more than ane block Increase was being requested, some smaller 
number than requested may hare been obtained, 

5*4 The Scheduler 

The scheduler runs when a quantum tlma-out occurs or when the physically 
running procedure encounters a blocking condition or causes an interrupt by 
some program action (memory protection Tic 1st ion, PDI, oTBrflow p etc.), the 
scheduler decides Yhlch procedure should run next by an aE&aiuatioEi of the 
variables [App C] in the system for each procedure. It simultaneously performs 
those modifications of these variables necessary to provide the simulated 
Interrupt feature [Sec 5.2], 

lor those procedures that have their stop word [App C] Eero, their 
runnablllty IS determined by a variable known as the flush Instruction which is 
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act when tae procedure becomes blocked* If this variable Is zero the procedure 
U ruaatiLe, if nonsero It Is executed with the procedure '% EPDLS variable [App 
C] loaded into ITS symbolic accumulator T* If the Instruction skips then the 
procedure Is runable and has Just become unblocked. If the flush instruction 
docs not skip the procedure is still blocked. 

The next procedure to be run is picked from among the runnable procedurea 
by a scan which considers two *resource" variables per procedure. Both of 
these are Quantized approximations to exponential decays toward proportions of 
machine time* The JTMU variable is associated with a particular procedure 
.while the UIWPTR variable pointer for that procedure points to a Quantity 
similar to JTHU maintained for all procedures in one console controlled tree. 
During the sc=iQ in select the next procedure to run, a procedure will be 
prefersd to the bast so far if its console tree has used less Ume recently 
tnan that of the best so far or Its console tree has used exactly the same 
amount and the procedure has used less time recently or Its console tree has 
used more but the procedure lass than one Quarter as much &s the beet bo far* 

All disowned job s DTMPTE's poiftt to a single word which la given leas 
resource than that for a normal console tree. The ays tea job [Sec 7*5] ie also 
given lower than normal priority* 

5*5 The .SU5ET DUG 
% 

Procedures may examine some of their system variables [App C] by means of 
this system call {.CA.1L 13,)' It is essentially the same as the .U$ET UUO [Sec 
6+2,3] except that no input-output channel is specified, since it is understood 
tn refer to the variable a of the procedure executing U+ AUo variables may 
only be esanined and tnen only if the 1*3 bit is Oh ia the variables mode 
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5. Provednffi Interaction 

6*1 The HierarchLai Organisation of Procedures 

All procedures operation under ITS are members of a tree structure 
recorded in the system to associating with each a pointer to its Immediate 
superior* If thto pointer Is minus one it indicates that the procedure tops a 
tree* These trees nay he of two types, those under the control of a Console 
and those that are disowned [$*c 6*2*2]. 

Console "controlled* trees have had their ton Level procedure 
automatically loaded "by IT& [See 2*1]. Since procedures may control their 
inferiors and the most that the user can do in appealing for aid when 
confronted with recalcitrant programs Is to cause his console to converse with 
higher leiel procedures [Sec 2,i]* he is actually at the mercy of this top 
level progrea, It is currently a DDT expanded hy the addition of new commands 
related to time sharing [Kef 2 , 8, 10]* The only restrictions deliberately 
Inserted in it relate to logging in [Sac 7.1]. 

Disowned procedure trees differ from console controlled trees only in the 
following wayst {!] they hare no console associated with thorn; 12} class one 
interrupts In a top level procedure are handled differently [See 5*2]j [3} they 
are scheduled with lower priority [Sec 5,4]; [4} certain system calls [Sec 
4,1.2, 6*1.2, 6,2„X 7*9,3, 7,3*4), when executed in them, are treated as 
illegal iuatractions* 

There exist a variety of means far procedures iinedlately above and below 
each other to interact [5«c 6*2, 8.3]. Procedures may also effect any 
procedure beneath them In the procedure tree by means of input-output 
translation table entries [Sec 3*3] amd an arbitrary pair of procedures may 
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converse treating each other as input-output duties a [Sec 4.3]. 

Among. the advantages of the above system of procedure organ Iwtl on are the 
following: 


(0 The highest level command processor (the tap level procedure of a COnSol* 
controlled tree) may vary arbitrarily from user to user* In actual operation, 
it is nOrbal to see HiCfile's whose inferior procedure variables and symbol 
tables much exceed their code* 

(3) flew versions of the highest level command processor may he introduced 
aiaply by writing a file on the disk with 150 Interruption to system continuity, 

(3) flew versions of the highest level command processor nay be easily and 
safely debugged by loading them as inferior procedures. In this position they 
cap exercise nil their normal functions except logging In and out* 

(4) It Is not neccessary to make every effort to remove all bugs fron the 
highest level command processor for fear that the system mav be destroyed by 
them* a consideration often Inhibiting more complex and powerful command 
languages, k fatal error simply results in the program, being reloaded, 

(5) Users have great generality In creating command levels of their own* 

{$) MulU-ta.sk programs, nay be organized in a consistent manner* 


Items 1, 2 , and 4 above arjue to various extents against pure procedures as 
does their inherent spaed inefficiency* Having to maintain separate copies of 
the highest level command processor for each user is not that significant a 
disadvantage if one considers the amount of each cdpy J s core image unique to 
each user and that while not in actual u$e they could be swapped out of the 
system* 
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6.1.1 Procedure Creation 

Procedures may be created only by typing "’Z on an Idle teletype [Sec 2,1] 
or by executing a *0PBfl [Sec 3.2] on device USR [Sac 4.12], In the seoond 
case, which la discussed here, there are strict rwiuiraent* GO l ^ e "file name" 
used in the ,QPEfl, The first file name, which, will be the USA'HE of the created 
procedure, must be the same as the tfWAKE of the procedure executing the ,OPBH, 
The second file name, which will be the J^AME of the created procedure, must be 
different from the JMKE of all Jobs then in existence that hare the tfflltft 
being used. A procedure may hare a naxlnmm of eight directly Inferior 
procedures, A newly created procedure will have one 2CKH) word block of cleared 
ie*ory and all of Its system variables Initialized, Suae as fallows: its 
interrupt uast words will be xero and its Interrupt level status word will be 
minus one [tec 5*2]: Its system na®e [Sec 3.8,4] will be set to Its 'dflAHE; its 
program counter (PC) will be set to zero; Its stop word [App Cj will have the 
user control bit on, 

6.1.2 Attaching Disowned Procedure Trees 

The only case in which a successful [See 3*2] on device tfSR [See 

4.12] nay be executed to provide an Inferior procedure (as opposed to opening a 
procedure for et&iinitlon Only) with a first file name different from the tlMAMK 
of the procedure executing the OPEN is that is which the top procedure of a 
disowned tree is being opened* this type of ,0PEH will be treated aa an 
illegal instruction if aianuted by a procedure la a disowned tree* If not ITS 
checks Only to see that the DjJAHE of the opening procedure and the JHAHE of the 
procedure being Opened Will fOrx a unique pair. If so and the opening 
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procedure baa less- than eight inferiors the Open vlll succeed aid ITS Hill 
modify the OflAXE of the opened procedure, to agree with, the open lug procedure. 
The URAHE'a of procedures. If any, deeper In the attached tree are not 
modified, 

6,1.3 The ptJTRAN CTJO 

When a procedure is first created hy a .OPE^, ITS assigns to It a hit for 
use in interrupts [Sec 5*£] to its Superior procedure different from that for 
any other inferior procedure its superior may have* Since inferior procedures 
can only be directly controlled when open on input-output channels, the loss of 
the n&ae of an inferior by its superior ah He U mas not open would result ia, 
complete loss of comnujilcatioa. Although procedures that hate inferiors 
normally keep close tract of their names and interrupt bits aa read by *U5ET's 
[See 6.3.3] p this system call (.CALL 3,) has been provided to translate from 
particular interrupt bit to name of inferior. The left half of of the contents 
of the effective address lust have only the appropriate interrupt hit on. If a 
corresponding lafartor procedure is found, the .UT3A3 skips and the OIArtE and 
JHAHE of the inferior art stored In the two words after the word containing the 
interrupt hit. if no corresponding inferior is found the .HTfttf Hill fail to 
skip and the two locations after the location it effectively addresses Hill he 
unmodified. 
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5,2 Controls Otar an I Medlately Inferior Procedure 

See also section 4,5+1+ 

6,2+1 The +DCE05E WO 

traced nr ea cay he destroyed only by the execution on a ,LG£DOT [Sen 7,1] 
or a ,0CLQ$E+ The second of these two system calls (+QF£ii 10) + which is 
discussed here, destroys the inferior procedure a pan on the channel specified 
by its accumulator field amd the entire procedure subtree of which this 
inferior is the top procedure, .CuQSE's [3ec 3+7,1] are autoiaticallr affected 
nn all channels of all the destroyed procedures and if any one of then is 
running the El 2JC MO display [Sec 4.U] a +T>Cl£)$E will be eiecuted for it. In 
order to kill certain cancerous types of procedure subtrees it has been found 
necessary to so Implement this ays ten call such that it first stops ail 
procedures in the subtree and than destroys them. 

6,2+2 The +1)1 SOW UVO 

This system call (,QPEi 27) reiuireS that an Ipferior procedure be open on 
the channel specified by its accumulator field. It causes this open procedure 
tn becnne the top "procedure of a disowned tree and in the process closes all 
channels on which the disowning procedure h&3 it open* A procedure in a 
disowned tree that tries to eiecuts this system can will be unsuccessful and 
receive an illegal instruction interrupt [Sec 5,2] as will a procedure trying 
to disown a subtree that controls the tree's console [Sec 4,5,i]. 
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6,2,3 The ,USET UUO 


In order to allow a procedure to set a^d read many of the ays ten variables 
[App C] associated with its Inferiors, this system call was created, Vhen 
executed Its acemulator field must contain the number of a chattel on which an 
Inferior procedure is open. The contents of its effective address is viewed as 
two half words with the right half pointing to the location from which the 
system variable i$ to he aet or into which the system variable is to he read. 
The left half specifies by Its top Mt (4,9) whether the system variable Is Id 
be read (aero) or written (one) and by the value of its remaining bits which 
system variable. The following table lists permissible values? 


3aae 

Value 

Type 

JIPC 

0 

7 

VALUE 
*VALtf£ [Sec 

1 

6,3,1], 

7 

TTT 

Z 

1 

FLSISS 

3 

1 

make 

4 

5 

JdAKE 

5 

7 

NAM 

6 

7 

UST? 

7 

3 

pi aid 

10 

7 

I STB 

11 

1 

MSN'P 

12 

7 

illegal to i 

reference 

« 

SV40 

13 

5 

IPIR3 

14 

7 

APIRq 

15 

7 

SHAKE 

IS 

7 

prcia 

17 * 

7 

KARA 

20 

7 

KAftPC 

Zl 

7 

UUOFt 

ZZ 

5 

UISD 

23 

1 

ROUT 

24 

5 

KSK2 

25 

7 

IFFlfl 

26 

27-77 

7 

0 


enable 

Program counter word. 

Contents of effective address of float recent 

Status relative to console [Sec 4,5]* 

B1 echini condition [Sec 5,t], 

[MAKE [Sec 4.12], 

MAKE [Sec 4*12]* 

Interrupt mas* word [Sec 5,2], 

Stop word (only bit 4*7 can be written)* 

Interrupt request word [Sec 3*2], 

Bit used to interrupt superior [Sec 6,1,3], 

Memory bound [Sec &,3], first location it would be 

Last eiacute! UUO trapping to system* 

Interrupt request word (written by an I3RM), 
Interrupt request word (written by &u AKUCAK), 
System name [Sec 3*7*4]* 

Interrupt level status word [Sen 5,2], 

KM register and control bits [Sec 7.4,2], 

Progrna Counter at last KM interrupt [Sec 7,4*1], 
Program Counter word at last system UUD, 

User index. 

Total run time in 4*053 microsecond units* 
Interrupt mails word two [Sec 5,2], 

Interrupt refuset word two [Ref 5*2], 

Unused* 
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IOC 1Q0+K 1 

EOS 120+1 1 

iop Ho+s l 


Input-output Cartel word for channel ft* 

Status word for Input-put put channel N, 

Nth ward of input-output channel push down list 


In the "type" column above* hit 1*1 cm indicates that the variable nay "be read* 
hit t,2 that it may he written, and hit 1.3 that It may he real with as *Stf3ET 
[See 5*31* 

4 

6.3 Gomnunication to an Immediately Superior Procedure 

6*3*1 The T ?iUF£ LTUD 

A. procedure executing this systea call (.GALL 4.J receives a class one 
interrupt [Sec 5*2] stopping it and interrupt in.? its superior procedure* The 
contents of the effective addres6 is saved in a system variabL; associated with 
the procedure [hpp c} so its superior can easily petrelve It wLth a *[ISET [Sac 
6*2*3] . 

6*3*2 The ,BREAK UUO 

The accumulator field and effective address of this m/D are Ignored hy 
ITS* A procedure executing It receives a class one interrupt [Sec 3.2] 
stopping It and interrupting its superior procedure. 
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7. Miscellaneous System C&LIa and Feature* 

7,1 The *tOCIri and .LOGOUT tfUQ's 

These two system calls. (.OFia S and ,OPER 33) are the only ones that are 
effective at only the top level* 

*LX0*JT has no effect and simply re turns fro a the system to the 
Instruction following if not executed ip a top level procedure* It causes the 
procedure tree in whoOS top procedure It is executed in to toe expunged from the 
sms** It works for both console controlled trees and disowned trees* Since 
the normal »eaus to create [Sec 6,1,1] and destroy [Sec 6.2,1] a procedure 
under ITS are calls in a superior procedure, the special case of the top level 
procedure must he bandied differently as it is toy *2 [Sec 2,1] and ,LO^D r Jr* 
.LGQIH is not restricted to top level procedures toy ITS but rather by 
HAGTRH* the top level procedure ITS automatically loads [Sec 2.1], K * LOG-1 R 
represents an attempt by a procedure to set its UHAME to the contents of the 
accuaultor specified* ThU Is allowed, by ITS only If the procedure's current 
IMME 13 minus one {as the UHL4E of initial HACTSK's is set) and the desired 
UHAM3 is neither zero nor minus one, Tn* success of a *LQ£tN Is signalled by 
its Skipping* HACTRN will not open Inferior procedures for a user until he has 
successfully loosed In at which point his inferior procedures will have ERIE'S 
dooming future .LCfclH's in that tree t-o failure. 
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7*2 Bonatindard Devices 

7 .2 A The *WS¥ !W0 

This 5/9U;* call (,GFH 20) reads {DATAl's [Bef l]) the contents of the 
data switches on the PSP-6'$ console Into the specified accumulator* 

7*2*2 The «BU76Q acid ,11*730 JJO's 

These systaa calls («0PEK 30 and tOFivR 31) respectively real the control 
register (COHI) of the device whose P3P^5 device number Is 730 into tha 
ooac if lad accumulator an 1 output (Cl(to) all bat the bottom three bits from the 
specified accumulator to the control register of the device [Etef 1] * The bits 
In tha control rests ter of this device are usually use! for temporary direct 
control or sense hookups* 

7*2*3 The JID7L0 UtfO 

The real tlae clock which ITS currently uses to time user quantuas haa, at 
well as an IntervaL tiling counter,, a clock counter which it neither sat or 
stopped by ITS* This systen call (\OPESt 4?) reads into the specified 
accumulator a wort whole bottom twenty four bits ape this clock counter*. It is 
incremented ones every 4*063 microsecends* 
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7,2,4 The ,OF£I and ,0^0 UUO's 

These ays ten calls (,OPEa 54 and ,0FB3 53) input nr output from their 
specflfied acc insulator and the two following locations from and to what will be 
an electric organ keyboard and tone generators, 

7,3 Various Times and the Date 

7.3,1 The ,EDTIHE UTJp 

This ay tea call UPPER 17) reads into the specified accumulator the 
internal system time which la a word Set to tern when a system Is first loaded 
and la incremented e?ery thirtieth of a second thereafter* 

7.3*2 The ,3T3KE UUO 

After the system has determined real (24 hour system) time. It maintains 
this internally as a number in units of one half second since the Last 
midnight* This system call (.QPEEt 45) reads into the specif led accumulator In 
siibit characters this tine in pairs of digits reading from the left hours, 
ainoitss, and seconds* If the tine has not yet been determined! minus one will 


be read 
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7-3,3 The *RDATE UUO 

After tba ays tea has determined th; cal radar date. It aain taina It 
Internally as a word with six sixbit characters I a it, These characters are 
all numeric. The first two are the last two digits of the year* the next two 
are the month nuiber, and the last two dibits are the lay of the month. This 
system call (,0PER 45) reals this word Into the specified accumulator. If the 
date has not yet been determined, minus one will be real. In the Current 
implementation, the date being determined Implies that the time [Sec 7,3,2] has 
been determined. The date is correctly incremented e^ery sldnight. 

7,4 The MAS Feature 

In order to simulate the address stop facility of the PDP-5 in a time 
shared mole, it was decided to Introduce a new hardware register, the haji 
rests ter, to cause Interrupts when a particular location was addressed by the 
computer. To Increase the flexibility of this feature* three control bits were 
aided which further define the Interrupt condition given that a memory address 

I 

match has occured, 

Among the system variables ttept by ITS for each procedure are its MAR 
register Contents and control bits. These are loaded into the hardware as the 
User is started, 'Since the MAX feature is intended primarily as a debugging 
aid. It causes a class two Interrupt [Sac 3.2] and the *tT5ET*s [Sec 5.2*3] 
corresponding to the following [TUG Is used more frequently than it is. 

When an MAh interrupt occurs, further MAR Interrupts are disabled Until 


the MAR It again set 
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7*4.1 the ,IMM UtTO 

This 3y&tem call (.OFSa 41) takes the right half of the specified 
accumulator as the new address to he put in the MAR register and the low three 
hits of the left half as conrol hits as follows; 

Ett Keating {oaa state) 

3.3 Interrupt if data read or written is negative, 

3,2 Interrupt If data read or written is positive, 

3.1 Interrupt only on a write. 

it this time, attempts to differentiate read cycles on the basis of sign will 
fall as, due to ft timing error, the lata aLw&ys appears positive, 

A .5US3T [Sec 3,3] may he used to read the word stored by the JSR at the 
systeals processor Interrupt channel location when the last MAS interrupt 
occured. Although., for their own safety, some parts of executive code inhibit 
MAR Interrupts, It is quite possible for the user to cause gone systei calls to 
Interrupt to the user, on reference to his core lraags where his MAR Is 

pointing. The progyaa counter word stored by the JSR at the user's location \Z 

[Sec 3,2} will be the location in his core ia&ge of the offending -system call. 
The word read by a *535ST will be an executive program counter Word showing the 
absolute location at which the system call attespted to reference the user's 


core image 
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7.5 The System Job 


There are various tasks ITS would Like to perform, most of which Include 
Input-output, which would he Inconvenient to Implement directly due to the 
procedure originated orientation of almost all system rountlnes* Because of 
this a procedure was synthesized that Is actually & part of the mohitor and 
always runs in executive node. Known as the system Job. it Is scheduled [Sec 
5.4] with lower priority than other procedures. To all In debugging ITS a 
feature was added to the system job so that when it had no other tashfi to 
perform It would compare constant parts of ITS against a copy It makes 
Initially [Sec 7.5,1], The following are some of the tasKs the system joh 
performs: 


{1) Does .CORE'S [Sec 5*3*1,] for ITS to a&fce room for more blocks of user 
variables or for the system Job's copy of constant parts of ITS. 

{2) Prints messages on the system console whenever an effective .SETtDC [Sec 
7.3,4]* .tOTLSB [Sec 3*9*3], or *0PEtt [Sec 3.2} on device SYS [Sec 4*2] for 
output Is executed* 

(3) Prints messages On the system console when, a parity error* unreiuested 
change In teletype priority Interrupt channel allocation* memory excessively 
full condition, login, or logout occurs, 

(4) Initially determines the 24 hour time and calendar date (Sec 7,3.2. 7,3.3]+ 

(5) Prints a message on all teletypes when the system is first loaded, 

16} Outputs a "CDHSOLI FREE” message on any teletype when It is r.o longer open 
by any procedure. " 

(7) various tasks related to the sytem going down feature explained in section 
7*5*2 below* 
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7.5.1 Til# .SUPSET UUO 

The system job is partially controlled by ITS through a word in 
ays tea memory. Bits in the left half of this word represent repeats for some 
transient action. In the right half only the bottom hit {1* 1) Is currently 
used and controls the syste* cheating feature. If this bit is on. the system 
job mates a copy of the constant tarts of ITS and precedes to spend Its spar# 
time checking the areas tt copied against the copy. If a discrepancy occurs, a 
aessage is printed, and the copy corrected. If this hit is off, the system Job 
util destroy any copy it may hare, freeing that meaory and aost of the fraction 
of the machine time the system Jab uses when in cheating mole* 

The ,SilPSET system call {„OPEft 53) enables the user to control the system 
checking bit by SCR'ini? the contents of the right half of the specified 
accumulator with th* system. Job control word and returning the resulting talus 
in the specified accumulator. 

7.5.2 The System ‘loins town Feature 

To protlde an orderly means for th# termination of the operation of ITS-, a 
special feature has been added. It Is actiy&ted by setting absolute location 
37 negatire [either with the PDP-*S console keys ["Ref 1] or a ♦SETLOC [Sec 
7,3.4]), After till & is first noticed, all procedures for which it 13 enabled 
will recelr* a system going down Interrupt [Sec 5.2] and all free teletypes 
ha?e an appropriate message typed on them. At this tine a fire mlnut# timer is 
started and further Ts on idle teletypes Ignored [Sec 2.1], At the end of 
the five minute period or when th# number of console controlled tress in which 
successful .LOOK"a [Sec 7,1] bays been executed joes to zero, all trees are 
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forceably logged cut and a massage typed on iU tele types * Then a program Is 
loaded from device STS and started such that if the address switches on the 
PDP-5 console are set to aero and the amplifier and loudspeakers attached to 
the low order bits of the memory indicator turned on* a rendition of the United 
States national anthem will he heard. 

7*3 Examining ITS 

7*5.1 The *SgfSTS UUO 


This sytem call (.OPUR £3} enables a procedure to receive copies of 
various internal monitor areas in such a way that the data in those areas must 
he consistent* The Specified accumulator contains a pointer word a3 for a 
block aode ,IOT [Sec 3*4]* The location following the specified accumulator 
containa, in left justified ei Kbit. the area requested as follows: 


Sirbit Area 

TRWS Translation table [Sec 3,3]* 

GETS List of things which can be requested with ,GETSTS. 

DET5 List of available symhloie input-output devices [App B] * 

MEM&RT Memory allocation tables [Sec 5.3]* 
iJTAPS UflC tape routine variables [Sec 4*1], 

DDLS* Disk routine variables [See 4,2], 

CLIUE Core link variables [Sec 4.3]* 

CALLS tut of symbols in squoie for system calls [App A] and .US£T [Sec 
6,3.3] left halves and their values. 

D3YS4S Symbol table for ITS. 

IMP! Area Input multiplexor cycle! into [Sec 4.0]* 

OMPI Area output multiplexor cycled from [Sec 4.10], 

U3SR3 User variables for all procedures* 

USSR User variables for particular user specified by DUKE and JHAMT 

in locations two and three greater than the specified accumulator [App C], If 
user not found location containing ffRAtif! will be wroed* 


Interrupts are inhibited to a sufficient extent that the data obtained, can not 
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ba Inconsistent due to the areas ualiflc&Uon while "bain® transferee to the 
ugsr . A successful *&ETSYS will ale Ip* One that falls* due to aon-recosaltiofl 
of Its slihlt word or insufficient msaory specified by Its pointer word, will 
not skip and in the former ease the sixblt word will be sflroed* 


7,3,2 The *&m<3C TO 

This sy steal call {*GPSR £5) simply transfers the eon tents of the absolute 
location pointer to by the left half of the specfled accumulator to the user's 
relative location pointed to by the rlsht half. If the right half points 
beyond the users memory bound he will receive an illegal instruction interrupt 

tSec 5,2] * 

7*6*3 Ths ,&3TSI MO 

This sytem call t*0P£a 52) reads into the specified accumulator the sixUt 
representation of the second file bum of the symbolic file that was assembled 
to produce the running version of ITS. 

7.7 The One Proceed Feature 

The Project H*C AI Group PDP-6 has been modified so that there eiists a 
mode In which It escutes one Instruction and then traps. This mode Is 
properly stored when an Interrupt occurs and Is restored by JEST l, [fief 1] * 

For users it causes a class one interrupt and is etpect&i to be used by 
superior procedures by ^ETlafi [Sec 6*2*3] the 3*3 hit of their Inferior's 
program counter word* There is coding in ITS such that all system calls will 
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ajipaar to be single las true tioaa US lag this mode* IFhile la this mode a user 
Interrupt may tie serviced and the users status, including this soda-, will he 
res tor*! by a normal .DISMISS [Sec 5,£,E]« 

7.9 Miscellaneous 

7.3*1 Tfos .SLEEP UUO 

This system Call (*OPEH 31 allows a procedure to stop running, while 
remaining Laterruntable, by either specifying a length at time to remain 
eiuescsnt or a particalar Use to wafce up* If the specified accumulator 
contains a positive number it Ls considered the length of time, la thirtieths 
of a second, that the procedure wishes to sleep. If the specified accumulator 
contains a negative number then the procedure will sleep until the magnitude of 
system tUe (as real by .3ETIME [Sac 7,3.1]) is greater than the magnitude of 
this nogatits number* tfhea a .SLEEP returns, the accumulator specified will be 
&aro p . but if a program ls interrupted out of either type of *S1£EP the 
accumulator will be seen to contain the appropriate negative number* 

7 *8* 2 The .GENSYM MO 

This system call {.OPER 3E) reUrna ifl the specified accumulator a valid 
a libit flle-Due-im s/abol that will he unique among those returned by 
.GEHaYM's for a particular system* 
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7.8,3 The ,ims-Et <juq 

Procedures run by ITS in IOT-user mode may eiftdute hardware toput-output 
instruction* which would otherwise by ineffectlte and trap to the monitor. 

This aystem call {,QFSR 3i) set the lOT-user status of the procedure executing 
It fron tha sign hit of the -specified accumulator. If this hit is a one and 
the procedure is not currently in IQT-user mode It will enter it and a message 
will he output by the system Job [Sec ?*5] unless the procedure is- in a 
disowned tree In which case it will receive an illegal instruction interrupt 
[Sec 5.3], 

7^,4 The ,$£TLQC UUQ 


This system call (,OP&a 2S) treats the opacified accumulator as two half 
word pointers. It takas the cos teats of the relatUe user location pointed to 
by the left half and places it Is the absolute location pointed to by the right 
half and causes the systta job to output an appropriate sassage [Sec 7,5] 
uoleas the procedure executing it is in a disownal tree in which case the 
procedure will recelTe an illegal instruction interrupt [Sec &,2], 
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k. System Calls Id Homeric Order 
tcormt aa of ITS werelsn 530) 


>lixiie 

Number 


Section 

JOT 

UUO 043 

3.4 

.OPEH 

UUO 041 

3.2 

.OPES 

OUO 042 

2,2.1 

, LISTS! 

,om 

2 

4,5,2 

..SLEEP 

.OPR 3 

7,3.1 

.SEIMSK 

.0P2R 

4 

5,2.1 

*SEtW2 

,5P3R 

5 

5,2.1 

*10011 

,0P2R 

6 

7.1 

.CLOSE 

*0PE3 

7 

3.7,1 

,UCL05E 

.OPEft 

It] 

6,2,1 

,ATTY 

,QPER 

11 

4,5.1 

,BW 

,OPER 

U 

4.5,1 

.ioktse 

.OPER 

13 

3,7,2 

jopof 

.OPE It 

14 

3,7,2 

.OCLdSE 

.OPER 

15 

4.11,3 

.DSTOP 

.OPBft 

16 

4,11,4 

.RDfIMS 

,OPER 

17 

7,3.1 

-ElDStf 

,OFSR 

20 

7.2,1 

.ITDISKT 

,0?2R 

zz 

4,1.1 

.asrsrs 

.0P3B 

23 

7.6,1 

*GMLOC 

■ OFHt 

25 

7.3,2 

.SETIOC 

.OPER 

26 

7,9,4 

.DISCWH 

.OPErt 

27 

6.2.2 

.RD760 

.OPER 30 

7.2.2 

,Wfl760 

.OFlfcJ 

31 

7.2.2 

.GEgSYH 

.OPfijt 

32 

7.5.2 

*LOOOUT 

.OpEJt 

33 

7,1 

^SHAHS 

,OPEJt 

35 

3,9.4 

.OHSET 

.OPSS 36 

5.2.3 

.reset 

,OP£R 37 

3.7,3 


,OT£R 

41 

7,4,2 

.ASSIOH 

,OPER 

43 

4,1.2 

.DBS 13 S 

*0PB& 

44 

4,1.2 

.HTXHB 

♦OFER 

45 

7,3.2 

, REAPS 

♦opsa 

45 

7.3.3 

.ramo 

♦ 0FSR 

47 

7.2.3 

.BOFC 

>om so 

3,4.1 

JOTLSR 

,0P2ft 

51 

7.3.3 

,R51TSt 

.OPES 

52 

7.6.3 

,SQPSET 

.ope a 

53 

7.5.1 

,OTKO 

.aps.it 

54 

7.2,4 

,DSGI 

.OPEit 

55 

7,2,4 

,UBUT 

.OPER 56 

4.1,3 

.IOPDl 

,OP£R 

57 

3,7.2 

JTHC 

.OPER 

60 

3,9.3 

.MA3TES 

.OPSR 

61 

App 0 

.DUL 

,OP2R 

63 

App E 
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«DIALM .OPER 64 App D 

.HAHSUF .OPE3 65 Ass? T> 

.CALL WO 043 2.2.1 

,DtSMlS .CALL 1, 5*2.2 

* "PEAKS .CALL 2, 3,3.1 

*THAMAD .CALL 3, 3.3*2 

*PALU£ .CALL 4, 6.3.1 

.1JT2AK .CALL 3, 6.1*1 

.CORE .CALI S r 5.3.1 

.TRAH&L .CALL 7, 3.3*3 

.DSTAftT .CALL 10* 4*11.1 

.PDSLS .CALL 11, 3*& 

.USTRTL .CALL 12, 4,11.1 

.SflSET .CALL 13, 5.5 

,LTP£1 .CALL 14. 4,11.2 

.US £t OTTO 044 6,2.3 

.BREAJE ffUD 045 6.3.2 

.STATUS DUO 046 3,6 

.ACCESS UUO 047 3.3.5 
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Appanlii J A 

^ Available Symbolic Devices In Alplaabettc Order 
{correct as of ITS wraiaa 550) 


Cto 

4.3 

.See 

CLU 

4.3 

.See 

COD 

4,14 

'Sec 

COX 

4.2 

'Sec 

DDc 

4.2 

Sec 

CIS 

4,11 

>of 

IDS 

4.11 


IMS 

4.5 

'Sec 

LPT 

4.5 

.Sec 

m 

4,4 


STD 

4.13 

Sec 

mt 

4.10 

;-Ref 

PLT 

4.? 

Sec 

FTP 

4 . a 

:ssc 

PTR 

43 

Sec 

STS 

4.2 

'sec 

Tn* 

4,5 

.Sec 

tty 

4.5 

|Sec 

USE 

4.12 

Sec 

UTn 

44 

.Sec 

71 D 

4,13 

.See 


i,4 


3,3.4] 

3.3*4] 


3.4.2, a,a,4) 


3.4; Ref 5,3] 


5, 5] 


Sftf 9] 


2,1, 3.4; Rif 1, t 
[See 2.1, 3.4; Rif 1. 7.1 
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Appendi! 

fl* System Variables per User 
(correct as of ITS Torsion 3S0) 


lOCMHi 

ilOCaa: 

iLuCP: 

UFC: 

AC05: 

AClSSl 

AClSS; 

AC17SI 

UUu: 

ajixiTi 

5UUQH; 

SACJ.7PI 

ACliPl 

ACl&Pi 

AC16P: 

«Pe 

41Fi 

Ufrti 

AM* 

UQUa«; 
EJiTPi 
PlfiftCs 
SUEP EG: 
PICLRj 
MSaST ; 
PLiIJiSi 
MJttCSOF: 
JtMiHTi 
SV4Qt 
USAXS: 
JSAJiZi 
TTTTELi 
VA^UIi: 
UEI&Cdu 
USTSHM: 
USYSHli 
I0CHSTi 
UT5JTM: 
UTEFESj 
JTKbi 
IOTLS&: 


UKAfiFC; 
aUPti: 
UP1UAL; 
IFPIHe 


BLOCK ZQ {input-output charnel words 
BLOCK LUIQP {Input-output chaniLeL past! down list 
& 1GCttM— l \ pointer into Input-Output push down list 
0 ;stores program counter when not running 

BLOCK IS {swap cut accumulators 
D {Cttuoaly referenced swap nut accumulator 

! > - 

0 V 


JEST £,0UCQfl ;u»r UUQ exit Instruction 
0 {contents of &4I (absolute) 

MDVEM U* {accumulator 1? In user*s smadow memory 
0 {points,, to accumulator 14 lb shadow memory 

0 i 15 

0 ; 15 

0 ipQi£t£ Accuser's relative location 40 

0 { 41 

4 {protection and relocation registers 

APRCHR {cone to processor 

;4*9 implies user in ,UCLOS£ 

0 ;quasiturn time 

0 ;etop word isero implies runnable 

C ipaikdlng interrupts 

0 ;pointer add interrupt bit to superior procedure 

0 {interrupt lerel status flag 

0 {interrupt enable nasi 

Q {blocking condition Instruction 

0 {sin Less than first illegal location 

0 {first illegal location 

0 {last interrupting UUD 

0 {user name 

0 {job name 

0 {console assignment for this procedure 

0 {contents of effective address of last .VALUE 

-1 jiero Implies top procedure of a disowned tree 
5 {current system name 

0 {system name used inside dlsit routines 

BLQCa 2& {input-output channel statue words 
0 {total run tine 

Q {pointer to procedure tree resource word 

0 {procsdure resource word 

0 {4*9 a one implies lot-user node' 

;4*5-4,3 MAE conditions 
i£.9-1*1 contents of MAE register 
Cl {program counter at last KAR interrupt 

0 {protection and relocation registers actually used 

0 {Bontero implies finalization required to interrupt 

0 {second word of interupt requests 
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USRPDLi 

SJPlSLs 

EPDLi 

1-PDUi 


0 | second word interrupt enable mask 

-LIPDL„UPT>L~1 jPUih dolist pointer for system calls 
BLOCK UGPDL-2 jpnsh down list area for system calls 
0 ;temporarily saves acco^lator k for AGORS 

0 ;temporarily saves aaeujnilator T for FLSIrS 
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Append!r 

D* Further Sources of Information on ITS 

Information further then or more recent than that contained in this manual 
sky usually he obtained by consulting the symbolic listings of ITS. The 
folioving persons may also be helpful! 

Donald E* Eaatl&jie III 
Diehard D. Greenblatt 
Thomas F* Knight 
John T. Hullonay 


Stcuart 2» Nelson 


